Compartir a través de

az devcenter dev customization-group

Note

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

Administrar grupos de personalización.

Comandos

Nombre Description Tipo Estado
az devcenter dev customization-group create

Cree un grupo de personalización.

 Extension GA
az devcenter dev customization-group list

Enumera los grupos de personalización en el cuadro de desarrollo.

 Extension GA
az devcenter dev customization-group show

Obtener un grupo de personalización.

 Extension GA

az devcenter dev customization-group create

Cree un grupo de personalización.

az devcenter dev customization-group create --customization-group-name --name
                                            --dev-box --dev-box-name
                                            --project --project-name
                                            [--dev-center --dev-center-name]
                                            [--endpoint]
                                            [--tasks]
                                            [--user-id]

Ejemplos

Creación mediante el Centro de desarrollo

az devcenter dev customization-group create --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

Creación mediante el punto de conexión

az devcenter dev customization-group create --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

Parámetros requeridos

--customization-group-name --name -n

Nombre del grupo de personalización.

--dev-box --dev-box-name

Nombre del cuadro de desarrollo.

--project --project-name

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--dev-center --dev-center-name -d

Nombre del centro de desarrollo. Use az configure -d dev-center=<dev_center_name> para configurar un valor predeterminado.

--endpoint

Punto de conexión de API para los recursos de desarrollador. Use az configure -d endpoint=<endpoint_uri> para configurar un valor predeterminado.

--tasks

Objeto Parameters para las tareas. Valor esperado: json-string/json-file/@json-file.

--user-id

Identificador de objeto de AAD del usuario. Si el valor es "me", la identidad se toma del contexto de autenticación.

Propiedad Valor
Valor predeterminado: me
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az devcenter dev customization-group list

Enumera los grupos de personalización en el cuadro de desarrollo.

az devcenter dev customization-group list --dev-box --dev-box-name
                                          --project --project-name
                                          [--dev-center --dev-center-name]
                                          [--endpoint]
                                          [--include-tasks {false, true}]
                                          [--user-id]

Ejemplos

Enumeración mediante el Centro de desarrollo

az devcenter dev customization-group list --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000" --include-tasks

Enumeración mediante punto de conexión

az devcenter dev customization-group list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000" --include-tasks

Parámetros requeridos

--dev-box --dev-box-name

Nombre del cuadro de desarrollo.

--project --project-name

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--dev-center --dev-center-name -d

Nombre del centro de desarrollo. Use az configure -d dev-center=<dev_center_name> para configurar un valor predeterminado.

--endpoint

Punto de conexión de API para los recursos de desarrollador. Use az configure -d endpoint=<endpoint_uri> para configurar un valor predeterminado.

--include-tasks

Parámetro opcional para incluir información de tareas en la respuesta.

Propiedad Valor
Valores aceptados: false, true
--user-id

Identificador de objeto de AAD del usuario. Si el valor es "me", la identidad se toma del contexto de autenticación.

Propiedad Valor
Valor predeterminado: me
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az devcenter dev customization-group show

Obtener un grupo de personalización.

az devcenter dev customization-group show --customization-group-name --name
                                          --dev-box --dev-box-name
                                          --project --project-name
                                          [--dev-center --dev-center-name]
                                          [--endpoint]
                                          [--user-id]

Ejemplos

Uso del centro de desarrollo

az devcenter dev customization-group show --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

Obtención del uso del punto de conexión

az devcenter dev customization-group show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

Parámetros requeridos

--customization-group-name --name -n

Nombre del grupo de personalización.

--dev-box --dev-box-name

Nombre del cuadro de desarrollo.

--project --project-name

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--dev-center --dev-center-name -d

Nombre del centro de desarrollo. Use az configure -d dev-center=<dev_center_name> para configurar un valor predeterminado.

--endpoint

Punto de conexión de API para los recursos de desarrollador. Use az configure -d endpoint=<endpoint_uri> para configurar un valor predeterminado.

--user-id

Identificador de objeto de AAD del usuario. Si el valor es "me", la identidad se toma del contexto de autenticación.

Propiedad Valor
Valor predeterminado: me
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False