.TH "GCLOUD_BETA_IAM_WORKFORCE\-POOLS_CREATE" 1



.SH "NAME"
.HP
gcloud beta iam workforce\-pools create \- create a new workforce pool under an organization



.SH "SYNOPSIS"
.HP
\f5gcloud beta iam workforce\-pools create\fR (\fIWORKFORCE_POOL\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR) \fB\-\-organization\fR=\fIORGANIZATION\fR [\fB\-\-allowed\-services\fR=[\fIdomain\fR=\fIDOMAIN\fR]] [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-disable\-programmatic\-signin\fR] [\fB\-\-disabled\fR] [\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fB\-\-session\-duration\fR=\fISESSION_DURATION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Creates a workforce pool under an organization given a valid
organization ID.



.SH "EXAMPLES"

The following command creates a workforce pool with ID \f5my\-workforce\-pool\fR
in the organization \f5\fI12345\fR\fR:

.RS 2m
$ gcloud beta iam workforce\-pools create my\-workforce\-pool \e
    \-\-organization=12345
.RE

The following command creates a workforce pool with ID \f5my\-workforce\-pool\fR
with explicit values for all required and optional parameters:

.RS 2m
$ gcloud beta iam workforce\-pools create my\-workforce\-pool \e
    \-\-organization=12345 \-\-location=global \e
    \-\-display\-name="My Workforce Pool" \e
    \-\-description="My workforce pool
description." \-\-session\-duration="7200s" \-\-disabled
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Workforce pool resource \- The workforce pool to create. The arguments in this
group can be used to specify the attributes of this resource.

This must be specified.


.RS 2m
.TP 2m
\fIWORKFORCE_POOL\fR

ID of the workforce pool or fully qualified identifier for the workforce pool.

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

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

The location for the workforce pool.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5workforce_pool\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION\fR

The parent organization of the workforce pool to create.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-allowed\-services\fR=[\fIdomain\fR=\fIDOMAIN\fR]

Services allowed for web sign\-in with the workforce pool. The flag accepts
multiple values with the key as \f5domain\fR and value as the domain of the
service allowed for web sign\-in. If not set, by default all the services are
allowed.

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

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

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

A description for the workforce pool. Cannot exceed 256 characters in length.

.TP 2m
\fB\-\-disable\-programmatic\-signin\fR

Disable programmatic sign\-in for workforce pool users.

.TP 2m
\fB\-\-disabled\fR

Whether or not the workforce pool is disabled.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

A display name for the workforce pool. Cannot exceed 32 characters in length.

.TP 2m
\fB\-\-session\-duration\fR=\fISESSION_DURATION\fR

How long the Google Cloud access tokens, console sign\-in sessions, and gcloud
sign\-in sessions from this workforce pool are valid. Must be greater than 15
minutes (900s) and less than 12 hours (43200s). If not configured, minted
credentials will have a default duration of one hour (3600s).


.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 "NOTES"

This command is currently in beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud iam workforce\-pools create
.RE

.RS 2m
$ gcloud alpha iam workforce\-pools create
.RE