Compartir a través de


az extension

Administre y actualice extensiones de la CLI.

Comandos

Nombre Description Tipo Estado
az extension add

Agregue una extensión.

Core GA
az extension list

Enumere las extensiones instaladas.

Core GA
az extension list-available

Enumera las extensiones disponibles públicamente.

Core GA
az extension list-versions

Enumerar las versiones disponibles para una extensión.

Core GA
az extension remove

Quite una extensión.

Core GA
az extension show

Mostrar una extensión.

Core GA
az extension update

Actualice una extensión.

Core GA

az extension add

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

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.

--allow-preview

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

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

Propiedad Valor
Grupo de parámetros: Experimental Pip Arguments
--pip-proxy

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

Propiedad Valor
Grupo de parámetros: Experimental Pip Arguments
--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.

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

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az extension list

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.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az extension list-available

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

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.

--show-details -d

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

Propiedad Valor
Valor predeterminado: False
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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az extension list-versions

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.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az extension remove

Quite una extensión.

az extension remove --name

Ejemplos

Quite una extensión. (autogenerated)

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.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az extension show

Mostrar una extensión.

az extension show --name

Ejemplos

Mostrar una extensión. (autogenerated)

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.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az extension update

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

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.

--allow-preview

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

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

Propiedad Valor
Grupo de parámetros: Experimental Pip Arguments
--pip-proxy

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

Propiedad Valor
Grupo de parámetros: Experimental Pip Arguments
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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False