Share via


az devcenter admin devcenter

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 devcenter . Obtenga más información sobre las extensiones.

Administrar centros de desarrollo.

Comandos

Nombre Description Tipo Estado
az devcenter admin devcenter create

Cree un centro de desarrollo.

Extensión GA
az devcenter admin devcenter delete

Elimina un centro de desarrollo.

Extensión GA
az devcenter admin devcenter list

Enumere todos los centros de desarrollo de un grupo de recursos.

Extensión GA
az devcenter admin devcenter show

Obtén un centro de desarrollo.

Extensión GA
az devcenter admin devcenter update

Actualizar un centro de desarrollo.

Extensión GA
az devcenter admin devcenter wait

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

Extensión GA

az devcenter admin devcenter create

Cree un centro de desarrollo.

az devcenter admin devcenter create --name
                                    --resource-group
                                    [--display-name]
                                    [--identity-type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                                    [--install-azure-monitor-agent-enable-status {Disabled, Enabled}]
                                    [--location]
                                    [--microsoft-hosted-network-enable-status {Disabled, Enabled}]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--plan-id]
                                    [--project-catalog-item-sync-enable-status {Disabled, Enabled}]
                                    [--tags]
                                    [--user-assigned-identities]

Ejemplos

Crear

az devcenter admin devcenter create --location "eastus" --tags CostCode="12345" --name "Contoso" --resource-group "rg1"
az devcenter admin devcenter create --identity-type "UserAssigned" --user-assigned-identities "{\"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/identityGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity1\":{}}" --location "eastus" --tags CostCode="12345" --name "Contoso" --resource-group "rg1"

Parámetros requeridos

--name -n

Nombre del centro de desarrollo.

--resource-group -g

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

Parámetros opcionales

--display-name

Nombre para mostrar del centro de desarrollo.

--identity-type

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

valores aceptados: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--install-azure-monitor-agent-enable-status -a

Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo.

valores aceptados: Disabled, Enabled
--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.

--microsoft-hosted-network-enable-status -m

Indica si los grupos de esta Centro de desarrollo pueden usar redes hospedadas de Microsoft. El valor predeterminado es Habilitado si no se establece.

valores aceptados: Disabled, Enabled
--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
--plan-id
Vista previa

Identificador de recurso de un plan asociado.

--project-catalog-item-sync-enable-status -c

Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo.

valores aceptados: Disabled, Enabled
--tags

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

--user-assigned-identities -u

Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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 devcenter delete

Elimina un centro de desarrollo.

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

Ejemplos

Eliminar

az devcenter admin devcenter delete --name "Contoso" --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 -n

Nombre del centro de desarrollo.

--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
--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 devcenter list

Enumere todos los centros de desarrollo de un grupo de recursos.

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

Ejemplos

Enumeración por grupo de recursos

az devcenter admin devcenter list --resource-group "rg1"

Lista por suscripción

az devcenter admin devcenter list

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.

--resource-group -g

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

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 devcenter show

Obtén un centro de desarrollo.

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

Ejemplos

Obtener

az devcenter admin devcenter show --name "Contoso" --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 -n

Nombre del centro de desarrollo.

--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 devcenter update

Actualizar un centro de desarrollo.

az devcenter admin devcenter update [--add]
                                    [--display-name]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--identity-type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                                    [--ids]
                                    [--install-azure-monitor-agent-enable-status {Disabled, Enabled}]
                                    [--microsoft-hosted-network-enable-status {Disabled, Enabled}]
                                    [--name]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--plan-id]
                                    [--project-catalog-item-sync-enable-status {Disabled, Enabled}]
                                    [--remove]
                                    [--resource-group]
                                    [--set]
                                    [--subscription]
                                    [--tags]
                                    [--user-assigned-identities]

Ejemplos

Actualizar

az devcenter admin devcenter update --tags CostCode="12345" --name "Contoso" --resource-group "rg1"

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 o JSON string>.

--display-name

Nombre para mostrar del centro de desarrollo.

--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
--identity-type

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

valores aceptados: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--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".

--install-azure-monitor-agent-enable-status -a

Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo.

valores aceptados: Disabled, Enabled
--microsoft-hosted-network-enable-status -m

Indica si los grupos de esta Centro de desarrollo pueden usar redes hospedadas de Microsoft. El valor predeterminado es Habilitado si no se establece.

valores aceptados: Disabled, Enabled
--name -n

Nombre del centro de desarrollo.

--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
--plan-id
Vista previa

Identificador de recurso de un plan asociado.

--project-catalog-item-sync-enable-status -c

Si los catálogos de proyectos asociados a proyectos de este centro de desarrollo se pueden configurar para sincronizar elementos de catálogo.

valores aceptados: Disabled, Enabled
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --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=.

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

--user-assigned-identities -u

Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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 devcenter wait

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

az devcenter admin devcenter wait [--created]
                                  [--custom]
                                  [--deleted]
                                  [--exists]
                                  [--ids]
                                  [--interval]
                                  [--name]
                                  [--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 -n

Nombre del centro de desarrollo.

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