.TH "GCLOUD_ACTIVE\-DIRECTORY_DOMAINS_EXTEND\-SCHEMA" 1



.SH "NAME"
.HP
gcloud active\-directory domains extend\-schema \- initiate schema extension for a Managed Microsoft AD domain



.SH "SYNOPSIS"
.HP
\f5gcloud active\-directory domains extend\-schema\fR \fIDOMAIN\fR \fB\-\-description\fR=\fIDESCRIPTION\fR \fB\-\-ldif\-file\fR=\fIPATH_TO_FILE\fR [\fB\-\-async\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Initiate schema extension for a Managed Microsoft AD domain.

This command can fail for the following reasons:
.RS 2m
.IP "\(bu" 2m
The specified domain doesn't exist.
.IP "\(bu" 2m
The specified domain is either being created or updated.
.IP "\(bu" 2m
The specified domain is under maintenance.
.IP "\(bu" 2m
The active account doesn't have permission to initiate schema extension on the
specified domain.
.RE
.sp



.SH "EXAMPLES"

The following command initiates a schema extension for the domain
\f5my\-domain.com\fR in project \f5my\-project\fR, with description \f5Test
Description\fR, using the LDIF file \f5demo.ldif\fR

.RS 2m
$ gcloud active\-directory domains extend\-schema my\-domain.com \e
    \-\-description="Test Description" \-\-ldif\-file=demo.ldf \e
    \-\-project=my\-project \-\-async
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Domain resource \- Name of the Managed Microsoft AD domain for which you want to
extend schema. This represents a Cloud resource. (NOTE) Some attributes are not
given arguments in this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5domain\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIDOMAIN\fR

ID of the domain or fully qualified identifier for the domain.

To set the \f5domain\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5domain\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

Description of schema change.

.TP 2m
\fB\-\-ldif\-file\fR=\fIPATH_TO_FILE\fR

Local LDIF file path that contains commands for schema extension. The file size
can't be larger than 1 MB. Use a full or relative path to a local file
containing the value of ldif_file.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.


.RE
.sp

.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-access\-token\-file, \-\-account,
\-\-billing\-project, \-\-configuration, \-\-flags\-file, \-\-flatten,
\-\-format, \-\-help, \-\-impersonate\-service\-account, \-\-log\-http,
\-\-project, \-\-quiet, \-\-trace\-token, \-\-user\-output\-enabled,
\-\-verbosity.

Run \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBmanagedidentities/v1\fR API. The full documentation for
this API can be found at: https://cloud.google.com/managed\-microsoft\-ad/



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha active\-directory domains extend\-schema
.RE

.RS 2m
$ gcloud beta active\-directory domains extend\-schema
.RE