Compartir a través de

az ts

  • Referencia

Administrar especificaciones de plantilla en el ámbito de la suscripción o del grupo de recursos.

Comandos

Nombre Description Tipo Estado
az ts create

Cree una especificación de plantilla y una versión de especificación de plantilla.

 Principal GA
az ts delete

Elimine una versión especificada de especificación de plantilla o especificación de plantilla por nombre o identificador de recurso.

 Principal GA
az ts export

Exporte la versión y los artefactos de especificación de plantilla especificados (si los hay) a la carpeta de salida especificada.

 Principal GA
az ts list

Enumerar las especificaciones de plantilla o las versiones de especificación de plantilla.

 Principal GA
az ts show

Obtenga la versión especificada de especificación de plantilla o especificación de plantilla.

 Principal GA
az ts update

Actualice una versión de especificación de plantilla.

 Principal GA

az ts create

Cree una especificación de plantilla y una versión de especificación de plantilla.

az ts create --name
             --resource-group
             [--description]
             [--display-name]
             [--location]
             [--tags]
             [--template-file]
             [--ui-form-definition]
             [--version]
             [--version-description]
             [--yes]

Ejemplos

Cree una especificación de plantilla.

az ts create -g testRG --name TemplateSpecName -l WestUS --display-name "MyDisplayName" --description "Simple template spec" --tags key1=value1

Cree una versión de especificación de plantilla.

az ts create -g testRG --name TemplateSpecName -v 2.0 -l WestUS --template-file templateSpec.json --version-description "Less simple template spec" --tags key1=value1 key3=value3

Cree una especificación de plantilla y una versión de la especificación de plantilla.

az ts create -g testRG --name TemplateSpecName -v 1.0 -l WestUS --template-file templateSpec.json --display-name "MyDisplayName" --description "Simple template spec" --version-description "Version of simple template spec" --tags key1=value1 key2=value2

Parámetros requeridos

--name -n

Nombre de la especificación de plantilla.

--resource-group -g

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

Parámetros opcionales

--description

Descripción de la especificación de plantilla primaria.

--display-name -d

Nombre para mostrar de la especificación de plantilla.

--location -l

Ubicación para almacenar las versiones template-spec y template-spec. No se puede cambiar después de la creación.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--template-file -f

Ruta de acceso a un archivo de plantilla o archivo de Bicep en el sistema de archivos.

--ui-form-definition

Ruta de acceso del archivo uiFormDefinition en el sistema de archivos para la versión de especificación de plantilla.

--version -v

Versión de especificación de plantilla.

--version-description

Descripción de la versión de especificación de plantilla.

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

Elimine una versión especificada de especificación de plantilla o especificación de plantilla por nombre o identificador de recurso.

az ts delete [--name]
             [--resource-group]
             [--template-spec]
             [--version]
             [--yes]

Ejemplos

Elimine la especificación de plantilla especificada y todas las versiones.

az ts delete -g MyResourceGroup --name TemplateSpecName

Elimine la versión especificada de la especificación de plantilla.

az ts delete -g MyResourceGroup --name TemplateSpecName --version VersionName

Elimine la especificación de plantilla o la versión en función del identificador de recurso.

az ts delete --template-spec resourceID

Parámetros opcionales

--name -n

Nombre de la especificación de plantilla.

--resource-group -g

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

--template-spec -s

Identificador de recurso de especificación de plantilla.

--version -v

Versión de especificación de plantilla.

--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 ts export

Exporte la versión y los artefactos de especificación de plantilla especificados (si los hay) a la carpeta de salida especificada.

az ts export --output-folder
             [--name]
             [--resource-group]
             [--template-spec]
             [--version]

Ejemplos

Exporte la versión de especificación de plantilla especificada en función del identificador de recurso.

az ts export -s resourceID --output-folder C:/path/

Exporte la versión de especificación de plantilla especificada.

az ts export -g testrg --name TemplateSpecName --version VersionName --output-folder C:/path/

Parámetros requeridos

--output-folder

Carpeta existente para las exportaciones de salida.

Parámetros opcionales

--name -n

Nombre de la especificación de plantilla.

--resource-group -g

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

--template-spec -s

Identificador de recurso de especificación de plantilla.

--version -v

Versión de especificación de plantilla.

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

Enumerar las especificaciones de plantilla o las versiones de especificación de plantilla.

az ts list [--name]
           [--resource-group]

Ejemplos

Enumera todas las especificaciones de plantilla en la suscripción predeterminada actual.

az ts list

Enumera todas las especificaciones de plantilla de la suscripción especificada.

az ts list --subscription Subscription

Enumerar todas las especificaciones de plantilla en el grupo de recursos.

az ts list -g MyResourceGroup

Enumere todas las versiones de la especificación de plantilla primaria.

az ts list -g MyResourceGroup -n TemplateSpecName

Parámetros opcionales

--name -n

Nombre de la especificación de plantilla.

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

Obtenga la versión especificada de especificación de plantilla o especificación de plantilla.

az ts show [--name]
           [--resource-group]
           [--template-spec]
           [--version]

Ejemplos

Muestra la especificación de plantilla especificada.

az ts show -g testrg --name TemplateSpecName

Muestra la versión de especificación de plantilla especificada.

az ts show -g testrg --name TemplateSpecName --version VersionName

Muestra la versión de especificación de plantilla o especificación de plantilla especificada en función del identificador de recurso.

az ts show --template-spec resourceID

Parámetros opcionales

--name -n

Nombre de la especificación de plantilla.

--resource-group -g

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

--template-spec -s

Identificador de recurso de especificación de plantilla.

--version -v

Versión de especificación de plantilla.

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

Actualice una versión de especificación de plantilla.

az ts update [--description]
             [--display-name]
             [--name]
             [--resource-group]
             [--tags]
             [--template-file]
             [--template-spec]
             [--ui-form-definition]
             [--version]
             [--version-description]
             [--yes]

Ejemplos

Actualice el contenido de la plantilla de una versión de especificación de plantilla o especificación de plantilla en función del identificador de recurso.

az ts update --template-spec resourceID -f updatedFile.json

Actualice el nombre para mostrar y las etiquetas de una especificación de plantilla en función del identificador de recurso.

az ts update --template-spec resourceID --display-name "NewParentDisplayName" --tags key1=value1

Actualice la descripción de una versión de especificación de plantilla sin preguntar.

az ts update -g ExistingRG --name ExistingName -v 3.0 --version-description "New description" --yes

Actualice todas las propiedades de una versión de especificación de plantilla.

az ts update -g ExistingRG --name ExistingName -v 3.0 -f updatedTemplate.json --display-name "New parent display name" --description "New parent description" --version-description "New child description" --ui-form-definition formDefinition.json

Quite las etiquetas de la versión de especificación de plantilla sin preguntar.

az ts update -g ExistingRG --name ExistingName -v 3.0 -f updatedTemplate.json --tags --yes

Parámetros opcionales

--description

Descripción de la especificación de plantilla primaria.

--display-name -d

Nombre para mostrar de la especificación de plantilla.

--name -n

Nombre de la especificación de plantilla.

--resource-group -g

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

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--template-file -f

Ruta de acceso a un archivo de plantilla o archivo de Bicep en el sistema de archivos.

--template-spec -s

Identificador de recurso de especificación de plantilla.

--ui-form-definition

Ruta de acceso del archivo uiFormDefinition en el sistema de archivos para la versión de especificación de plantilla.

--version -v

Versión de especificación de plantilla.

--version-description

Descripción de la versión de especificación de plantilla.

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