- NAME
-
- gcloud beta iam workforce-pools create - create a new workforce pool under an organization
- SYNOPSIS
-
-
gcloud beta iam workforce-pools create(WORKFORCE_POOL:--location=LOCATION)--organization=ORGANIZATION[--allowed-services=[domain=DOMAIN]] [--async] [--description=DESCRIPTION] [--disable-programmatic-signin] [--disabled] [--display-name=DISPLAY_NAME] [--session-duration=SESSION_DURATION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Creates a workforce pool under an organization given a valid organization ID. - EXAMPLES
- The following command creates a workforce pool with ID
my-workforce-poolin the organization:12345gcloud beta iam workforce-pools create my-workforce-pool --organization = 12345The following command creates a workforce pool with ID
my-workforce-poolwith explicit values for all required and optional parameters:gcloud beta iam workforce-pools create my-workforce-pool --organization = 12345 --location = global --display-name = "My Workforce Pool" --description = "My workforce pooldescription." --session-duration = "7200s" --disabled - POSITIONAL ARGUMENTS
-
- 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.
-
WORKFORCE_POOL - ID of the workforce pool or fully qualified identifier for the workforce pool.
To set the
workforce_poolattribute:- provide the argument
workforce_poolon the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
- provide the argument
-
--location=LOCATION - The location for the workforce pool.
To set the
locationattribute:- provide the argument
workforce_poolon the command line with a fully specified name; - provide the argument
--locationon the command line.
- provide the argument
-
- Workforce pool resource - The workforce pool to create. The arguments in this
group can be used to specify the attributes of this resource.
- REQUIRED FLAGS
-
-
--organization=ORGANIZATION - The parent organization of the workforce pool to create.
-
- OPTIONAL FLAGS
-
-
--allowed-services=[domain=DOMAIN] - Services allowed for web sign-in with the workforce pool. The flag accepts
multiple values with the key as
domainand value as the domain of the service allowed for web sign-in. If not set, by default all the services are allowed. -
--async - Return immediately, without waiting for the operation in progress to complete.
-
--description=DESCRIPTION - A description for the workforce pool. Cannot exceed 256 characters in length.
-
--disable-programmatic-signin - Disable programmatic sign-in for workforce pool users.
-
--disabled - Whether or not the workforce pool is disabled.
-
--display-name=DISPLAY_NAME - A display name for the workforce pool. Cannot exceed 32 characters in length.
-
--session-duration=SESSION_DURATION - 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).
-
- 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
$ gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud iam workforce-pools creategcloud alpha iam workforce-pools create
gcloud beta iam workforce-pools create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

