Compartir a través de

az extension

  • Referencia

Administre y actualice extensiones de la CLI.

Comandos

Nombre Description Tipo Estado
az extension add

Agregue una extensión.

 Núcleo GA
az extension list

Enumere las extensiones instaladas.

 Núcleo GA
az extension list-available

Enumera las extensiones disponibles públicamente.

 Núcleo GA
az extension list-versions

Enumerar las versiones disponibles para una extensión.

 Núcleo GA
az extension remove

Quite una extensión.

 Núcleo GA
az extension show

Mostrar una extensión.

 Núcleo GA
az extension update

Actualice una extensión.

 Núcleo GA

az extension add

Editar

Agregue una extensión.

Para obtener información sobre cómo instalar extensiones automáticamente, visite https://aka.ms/AzExtDynamicInstall.

az extension add [--allow-preview {false, true}]
                 [--name]
                 [--pip-extra-index-urls]
                 [--pip-proxy]
                 [--source]
                 [--system]
                 [--upgrade]
                 [--version]
                 [--yes]

Ejemplos

Agregar extensión por nombre

az extension add --name anextension

Adición de la extensión desde la dirección URL

az extension add --source https://contoso.com/anextension-0.0.1-py2.py3-none-any.whl

Adición de la extensión desde el disco local

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl

Agregar extensión desde el disco local y usar el proxy pip para las dependencias

az extension add --source ~/anextension-0.0.1-py2.py3-none-any.whl --pip-proxy https://user:pass@proxy.server:8080

Agregar extensión al directorio del sistema

az extension add --name anextension --system

Agregar una versión específica de la extensión

az extension add --name anextension --version 1.0.0

Actualizar la extensión si ya está instalada

az extension add --upgrade --name anextension

Parámetros opcionales

--allow-preview

Incluya paquetes de versión preliminar para la instalación de extensiones, si existe.

Valores aceptados: false, true
--name -n

Nombre de la extensión.

--pip-extra-index-urls

Lista separada por espacios de direcciones URL adicionales de índices de paquete que se van a usar. Esto debe apuntar a un repositorio compatible con PEP 503 (la API de repositorio simple) o un directorio local establecido en el mismo formato.

--pip-proxy

Proxy para que pip use para las dependencias de extensión en forma de [user:passwd@]proxy.server:port.

--source -s

Ruta de archivo o dirección URL a una extensión.

--system

Use un directorio del sistema para la extensión.

La ruta de acceso predeterminada es la carpeta azure-cli-extensions de la CLI que ejecuta la ruta de acceso lib del entorno de Python, configurable por la variable de entorno AZURE_EXTENSION_SYS_DIR. En Windows, es posible que tenga que abrir el shell como administrador para ejecutar con el permiso adecuado.

--upgrade

Actualice la extensión si ya está instalada; de lo contrario, simplemente instale la extensión.

--version

Versión específica de una extensión.

Valor predeterminado: latest
--yes -y

No solicita confirmación.

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.

az extension list

Editar

Enumere las extensiones instaladas.

az extension list
Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.

az extension list-available

Editar

Enumera las extensiones disponibles públicamente.

az extension list-available [--show-details]

Ejemplos

Enumerar todas las extensiones disponibles públicamente

az extension list-available

Enumerar los detalles de una extensión determinada

az extension list-available --show-details --query anextension

Parámetros opcionales

--show-details -d

Muestra los datos sin procesar del índice de extensión.

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.

az extension list-versions

Editar

Enumerar las versiones disponibles para una extensión.

az extension list-versions --name

Ejemplos

Enumerar las versiones disponibles de una extensión

az extension list-versions --name anextension

Parámetros requeridos

--name -n

Nombre de la extensión.

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.

az extension remove

Editar

Quite una extensión.

az extension remove --name

Ejemplos

Quite una extensión. (generado automáticamente)

az extension remove --name MyExtension

Parámetros requeridos

--name -n

Nombre de la extensión.

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.

az extension show

Editar

Mostrar una extensión.

az extension show --name

Ejemplos

Mostrar una extensión. (generado automáticamente)

az extension show --name MyExtension

Parámetros requeridos

--name -n

Nombre de la extensión.

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.

az extension update

Editar

Actualice una extensión.

az extension update --name
                    [--allow-preview {false, true}]
                    [--pip-extra-index-urls]
                    [--pip-proxy]

Ejemplos

Actualizar una extensión por nombre

az extension update --name anextension

Actualización de una extensión por nombre y uso del proxy pip para las dependencias

az extension update --name anextension --pip-proxy https://user:pass@proxy.server:8080

Parámetros requeridos

--name -n

Nombre de la extensión.

Parámetros opcionales

--allow-preview

Incluya paquetes de versión preliminar para la instalación de extensiones, si existe.

Valores aceptados: false, true
--pip-extra-index-urls

Lista separada por espacios de direcciones URL adicionales de índices de paquete que se van a usar. Esto debe apuntar a un repositorio compatible con PEP 503 (la API de repositorio simple) o un directorio local establecido en el mismo formato.

--pip-proxy

Proxy para que pip use para las dependencias de extensión en forma de [user:passwd@]proxy.server:port.

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.