Compartir a través de

az devcenter admin pool

  • Referencia

Nota:

Esta referencia forma parte de la extensión de devcenter para la CLI de Azure (versión 2.51.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az devcenter admin pool . Obtenga más información sobre las extensiones.

Administrar grupos.

Comandos

Nombre Description Tipo Estado
az devcenter admin pool create

Cree un grupo.

 Extensión GA
az devcenter admin pool delete

Eliminación de un grupo

 Extensión GA
az devcenter admin pool list

Enumera los grupos de un proyecto.

 Extensión GA
az devcenter admin pool run-health-check

Desencadena una actualización del estado del grupo.

 Extensión GA
az devcenter admin pool show

Obtener un grupo.

 Extensión GA
az devcenter admin pool update

Actualizar un grupo.

 Extensión GA
az devcenter admin pool wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión GA

az devcenter admin pool create

Cree un grupo.

az devcenter admin pool create --local-administrator {Disabled, Enabled}
                               --name
                               --project
                               --resource-group
                               [--devbox-definition-image-reference]
                               [--devbox-definition-name]
                               [--devbox-definition-sku]
                               [--devbox-definition-type {Reference, Value}]
                               [--display-name]
                               [--location]
                               [--managed-virtual-network-regions]
                               [--network-connection-name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--single-sign-on-status {Disabled, Enabled}]
                               [--stop-on-disconnect]
                               [--stop-on-no-connect]
                               [--tags]
                               [--virtual-network-type {Managed, Unmanaged}]

Ejemplos

Creación de un grupo mediante una red no administrada

az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled"

Creación de un grupo mediante una red administrada

az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Managed" --managed-virtual-network-region ["westus3"] --single-sign-on-status "Enabled"

Creación de un grupo con stop on disconnect enabled

az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled" --stop-on-disconnect status="Enabled" grace-period-minutes="60"

Creación de un grupo mediante la definición de imagen

az devcenter admin pool create --location "eastus" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled" --devbox-definition-type "Value" --devbox-definition-image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/projects/DevProject/images/~Catalog~image2~project-sample-2" --devbox-definition-sku name=""general_i_8c32gb256ssd_v2"

Parámetros requeridos

--local-administrator

Indica si los propietarios de cuadros de desarrollo de este grupo se agregan como administradores locales en el cuadro de desarrollo.

Valores aceptados: Disabled, Enabled
--name --pool-name -n

Nombre del grupo.

--project --project-name

Nombre del proyecto. Use az configure -d project=<project_name> para configurar un valor predeterminado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--devbox-definition-image-reference -i
Vista previa

Información de referencia de imagen para una definición de las máquinas que se crean a partir de este grupo. Se omitirá si el parámetro devbox-definition-type es Reference o no se proporciona. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--devbox-definition-name -d

Nombre de una definición de cuadro de desarrollo en el proyecto primario de este grupo. Se omitirá si el parámetro devbox-definition-type es Value.

--devbox-definition-sku -s
Vista previa

La SKU para Dev Boxes creada a partir del grupo. Se omitirá si el parámetro devbox-definition-type es Reference o no se proporciona. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--devbox-definition-type -t

Indica si el grupo se crea a partir de una definición de Dev Box existente o si se proporciona directamente uno.

Valores aceptados: Reference, Value
--display-name

El nombre para mostrar del grupo.

--location -l

Ubicación geográfica donde reside el recurso. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>. Cuando no se especifique, se usará la ubicación del grupo de recursos.

--managed-virtual-network-regions -m

Las regiones de la red virtual administrada (necesarias cuando managedNetworkType es Managed). Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--network-connection-name -c

Nombre de una conexión de red en el proyecto primario de este grupo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--single-sign-on-status

Indica si Los cuadros de desarrollo de este grupo se crean con el inicio de sesión único habilitado. También requiere que el inicio de sesión único esté habilitado en el inquilino.

Valores aceptados: Disabled, Enabled
--stop-on-disconnect

Detenga los valores de configuración de desconexión de los cuadros de desarrollo creados en este grupo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--stop-on-no-connect
Vista previa

Deténgase sin opciones de configuración de conexión para Dev Boxes creados en este grupo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--virtual-network-type

Indica si el grupo usa una red virtual administrada por Microsoft o una red proporcionada por el cliente.

Valores aceptados: Managed, Unmanaged
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az devcenter admin pool delete

Eliminación de un grupo

az devcenter admin pool delete [--ids]
                               [--name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--project]
                               [--resource-group]
                               [--subscription]
                               [--yes]

Ejemplos

Eliminar

az devcenter admin pool delete --name "DevPool" --project-name "DevProject" --resource-group "rg1"

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --pool-name -n

Nombre del grupo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Nombre del proyecto. Use az configure -d project=<project_name> para configurar un valor predeterminado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az devcenter admin pool list

Enumera los grupos de un proyecto.

az devcenter admin pool list --project
                             --resource-group
                             [--max-items]
                             [--next-token]

Ejemplos

List

az devcenter admin pool list --project-name "DevProject" --resource-group "rg1"

Parámetros requeridos

--project --project-name

Nombre del proyecto. Use az configure -d project=<project_name> para configurar un valor predeterminado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az devcenter admin pool run-health-check

Desencadena una actualización del estado del grupo.

az devcenter admin pool run-health-check [--ids]
                                         [--name]
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--project]
                                         [--resource-group]
                                         [--subscription]

Ejemplos

Ejecución de la comprobación de estado

az devcenter admin pool run-health-check --name "DevPool" --project-name "DevProject" --resource-group "rg1"

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --pool-name -n

Nombre del grupo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Nombre del proyecto. Use az configure -d project=<project_name> para configurar un valor predeterminado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az devcenter admin pool show

Obtener un grupo.

az devcenter admin pool show [--ids]
                             [--name]
                             [--project]
                             [--resource-group]
                             [--subscription]

Ejemplos

Obtener

az admin pool show --name "DevPool" --project-name "DevProject" --resource-group "rg1"

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --pool-name -n

Nombre del grupo.

--project --project-name

Nombre del proyecto. Use az configure -d project=<project_name> para configurar un valor predeterminado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az devcenter admin pool update

Actualizar un grupo.

az devcenter admin pool update [--add]
                               [--devbox-definition-image-reference]
                               [--devbox-definition-name]
                               [--devbox-definition-sku]
                               [--devbox-definition-type {Reference, Value}]
                               [--display-name]
                               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                               [--ids]
                               [--local-administrator {Disabled, Enabled}]
                               [--managed-virtual-network-regions]
                               [--name]
                               [--network-connection-name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--project]
                               [--remove]
                               [--resource-group]
                               [--set]
                               [--single-sign-on-status {Disabled, Enabled}]
                               [--stop-on-disconnect]
                               [--stop-on-no-connect]
                               [--subscription]
                               [--tags]
                               [--virtual-network-type {Managed, Unmanaged}]

Ejemplos

Actualizar

az devcenter admin pool update --devbox-definition-name "WebDevBox2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --stop-on-disconnect status="Disabled"

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

--devbox-definition-image-reference -i
Vista previa

Información de referencia de imagen para una definición de las máquinas que se crean a partir de este grupo. Se omitirá si el parámetro devbox-definition-type es Reference o no se proporciona. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--devbox-definition-name -d

Nombre de una definición de cuadro de desarrollo en el proyecto primario de este grupo. Se omitirá si el parámetro devbox-definition-type es Value.

--devbox-definition-sku -s
Vista previa

La SKU para Dev Boxes creada a partir del grupo. Se omitirá si el parámetro devbox-definition-type es Reference o no se proporciona. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--devbox-definition-type -t

Indica si el grupo se crea a partir de una definición de Dev Box existente o si se proporciona directamente uno.

Valores aceptados: Reference, Value
--display-name

El nombre para mostrar del grupo.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--local-administrator

Indica si los propietarios de cuadros de desarrollo de este grupo se agregan como administradores locales en el cuadro de desarrollo.

Valores aceptados: Disabled, Enabled
--managed-virtual-network-regions -m

Las regiones de la red virtual administrada (necesarias cuando managedNetworkType es Managed). Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--name --pool-name -n

Nombre del grupo.

--network-connection-name -c

Nombre de una conexión de red en el proyecto primario de este grupo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Nombre del proyecto. Use az configure -d project=<project_name> para configurar un valor predeterminado.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

--single-sign-on-status

Indica si Los cuadros de desarrollo de este grupo se crean con el inicio de sesión único habilitado. También requiere que el inicio de sesión único esté habilitado en el inquilino.

Valores aceptados: Disabled, Enabled
--stop-on-disconnect

Detenga los valores de configuración de desconexión de los cuadros de desarrollo creados en este grupo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--stop-on-no-connect
Vista previa

Deténgase sin opciones de configuración de conexión para Dev Boxes creados en este grupo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--virtual-network-type

Indica si el grupo usa una red virtual administrada por Microsoft o una red proporcionada por el cliente.

Valores aceptados: Managed, Unmanaged
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az devcenter admin pool wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az devcenter admin pool wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--ids]
                             [--interval]
                             [--name]
                             [--project]
                             [--resource-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name --pool-name -n

Nombre del grupo.

--project --project-name

Nombre del proyecto. Use az configure -d project=<project_name> para configurar un valor predeterminado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.