Compartir vía

az automation configuration

  • Referencia

Nota:

Esta referencia forma parte de la extensión de automatización para la CLI de Azure (versión 2.55.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az automation configuration . Obtenga más información sobre las extensiones.

Administrar la configuración de Dsc.

Comandos

Nombre Description Tipo Estado
az automation configuration create

Cree la configuración identificada por nombre de configuración.

 Extensión GA
az automation configuration delete

Elimine la configuración de dsc identificada por nombre de configuración.

 Extensión GA
az automation configuration list

Enumerar una lista de configuraciones.

 Extensión GA
az automation configuration show

Obtenga la configuración identificada por nombre de configuración.

 Extensión GA
az automation configuration show-content

Obtenga el script de configuración identificado por nombre de configuración.

 Extensión GA
az automation configuration update

Actualice la configuración identificada por nombre de configuración.

 Extensión GA

az automation configuration create

Cree la configuración identificada por nombre de configuración.

az automation configuration create --account
                                   --configuration-name
                                   --resource-group
                                   [--description]
                                   [--location]
                                   [--log-progress {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--log-verbose {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--parameters]
                                   [--source]
                                   [--source-hash]
                                   [--source-type {embeddedContent, uri}]
                                   [--source-version]
                                   [--tags]

Ejemplos

Creación de una configuración de DSC que configura un servidor

az automation configuration create -g rg --automation-account-name myAutomationAccount -n SetupServer --location westus2 --source-type embeddedContent --source "Configuration SetupServer {
Node localhost {
WindowsFeature IIS {
Name = "Web-Server";
Ensure = "Present"
}
}
}"

Parámetros requeridos

--account --automation-account-name

Nombre de la cuenta de Automation.

--configuration-name --name -n

Parámetros de creación o actualización para la configuración.

--resource-group -g

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

Parámetros opcionales

--description

Obtiene o establece la descripción de la configuración.

--location

Obtiene o establece la ubicación del recurso.

--log-progress

Obtiene o establece la opción de registro de progreso.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Obtiene o establece la opción de registro detallado.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Obtiene o establece los parámetros de configuración. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--source

Obtiene o establece el valor del contenido. Esto se basa en el tipo de origen de contenido.

--source-hash

Obtiene o establece el hash. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--source-type

Obtiene o establece el tipo de origen de contenido.

valores aceptados: embeddedContent, uri
--source-version

Obtiene o establece la versión del contenido.

--tags

Obtiene o establece las etiquetas adjuntas al recurso. 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 automation configuration delete

Elimine la configuración de dsc identificada por nombre de configuración.

az automation configuration delete [--account]
                                   [--configuration-name]
                                   [--ids]
                                   [--resource-group]
                                   [--subscription]
                                   [--yes]

Ejemplos

Eliminar la configuración de DSC

az automation configuration list -g rg --automation-account-name myAutomationAccount

Parámetros opcionales

--account --automation-account-name

Nombre de la cuenta de Automation.

--configuration-name --name -n

Nombre de la configuración.

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

--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 automation configuration list

Enumerar una lista de configuraciones.

az automation configuration list --account
                                 --resource-group
                                 [--filter]
                                 [--inlinecount]
                                 [--max-items]
                                 [--next-token]
                                 [--skip]
                                 [--top]

Ejemplos

Enumerar todas las configuraciones de DSC

az automation configuration list -g rg --automation-account-name myAutomationAccount

Parámetros requeridos

--account --automation-account-name

Nombre de la cuenta de Automation.

--resource-group -g

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

Parámetros opcionales

--filter

Filtro que se aplicará a la operación.

--inlinecount

Devuelve el total de filas.

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

--skip

Número de filas que se van a omitir.

--top

Número de filas que se van a tomar.

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 automation configuration show

Obtenga la configuración identificada por nombre de configuración.

az automation configuration show [--account]
                                 [--configuration-name]
                                 [--ids]
                                 [--resource-group]
                                 [--subscription]

Ejemplos

Obtener la configuración por su nombre

az automation configuration show -g rg --automation-account-name myAutomationAccount -n SetupServer

Parámetros opcionales

--account --automation-account-name

Nombre de la cuenta de Automation.

--configuration-name --name -n

Nombre de la configuración.

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

--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 automation configuration show-content

Obtenga el script de configuración identificado por nombre de configuración.

az automation configuration show-content [--account]
                                         [--configuration-name]
                                         [--ids]
                                         [--resource-group]
                                         [--subscription]

Ejemplos

Mostrar el contenido del script de la configuración de DSC

az automation configuration show-content -g rg --automation-account-name myAutomationAccount -n SetupServer

Parámetros opcionales

--account --automation-account-name

Nombre de la cuenta de Automation.

--configuration-name --name -n

Nombre de la configuración.

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

--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 automation configuration update

Actualice la configuración identificada por nombre de configuración.

az automation configuration update [--account]
                                   [--add]
                                   [--configuration-name]
                                   [--description]
                                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--ids]
                                   [--location]
                                   [--log-progress {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--log-verbose {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--parameters]
                                   [--remove]
                                   [--resource-group]
                                   [--set]
                                   [--source]
                                   [--source-hash]
                                   [--source-type {embeddedContent, uri}]
                                   [--source-version]
                                   [--subscription]
                                   [--tags]

Ejemplos

Actualizar script en la configuración de DSC

az automation configuration update -g rg --automation-account-name myAutomationAccount -n SetupServer --location westus2 --source-type embeddedContent --source "Configuration SetupServer {
Node localhostServer {
WindowsFeature IIS {
Name = "Web-Server";
Ensure = "Present"
}
}
}"

Parámetros opcionales

--account --automation-account-name

Nombre de la cuenta de Automation.

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

--configuration-name --name -n

Nombre de la configuración.

--description

Obtiene o establece la descripción de la configuración.

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

--location

Obtiene o establece la ubicación del recurso.

--log-progress

Obtiene o establece la opción de registro de progreso.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Obtiene o establece la opción de registro detallado.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Obtiene o establece los parámetros de configuración. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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

--source

Obtiene o establece el valor del contenido. Esto se basa en el tipo de origen de contenido.

--source-hash

Obtiene o establece el hash. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--source-type

Obtiene o establece el tipo de origen de contenido.

valores aceptados: embeddedContent, uri
--source-version

Obtiene o establece la versión del contenido.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--tags

Obtiene o establece las etiquetas adjuntas al recurso. 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.