Condividi tramite

az automation configuration

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione di automazione per l'interfaccia della riga di comando di Azure (versione 2.55.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az automation configuration . Altre informazioni sulle estensioni.

Gestire la configurazione DSC.

Comandi

Nome Descrizione Tipo Stato
az automation configuration create

Creare la configurazione identificata dal nome della configurazione.

 Estensione Disponibilità generale
az automation configuration delete

Eliminare la configurazione dsc identificata dal nome della configurazione.

 Estensione Disponibilità generale
az automation configuration list

Elencare un elenco di configurazioni.

 Estensione Disponibilità generale
az automation configuration show

Ottenere la configurazione identificata dal nome della configurazione.

 Estensione Disponibilità generale
az automation configuration show-content

Ottenere lo script di configurazione identificato dal nome della configurazione.

 Estensione Disponibilità generale
az automation configuration update

Aggiornare la configurazione identificata dal nome della configurazione.

 Estensione Disponibilità generale

az automation configuration create

Creare la configurazione identificata dal nome della configurazione.

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]

Esempio

Creare una configurazione DSC che configura un server

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

Parametri necessari

--account --automation-account-name

Nome dell'account di automazione.

--configuration-name --name -n

Parametri di creazione o aggiornamento per la configurazione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--description

Ottiene o imposta la descrizione della configurazione.

--location

Ottiene o imposta il percorso della risorsa.

--log-progress

Ottiene o imposta l'opzione del log di stato.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Ottiene o imposta l'opzione di log dettagliata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Ottiene o imposta i parametri di configurazione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--source

Ottiene o imposta il valore del contenuto. Si basa sul tipo di origine del contenuto.

--source-hash

Ottiene o imposta l'hash. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--source-type

Ottiene o imposta il tipo di origine del contenuto.

valori accettati: embeddedContent, uri
--source-version

Ottiene o imposta la versione del contenuto.

--tags

Ottiene o imposta i tag associati alla risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az automation configuration delete

Eliminare la configurazione dsc identificata dal nome della configurazione.

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

Esempio

Eliminare la configurazione DSC

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

Parametri facoltativi

--account --automation-account-name

Nome dell'account di automazione.

--configuration-name --name -n

Nome della configurazione.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az automation configuration list

Elencare un elenco di configurazioni.

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

Esempio

Elencare tutte le configurazioni DSC

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

Parametri necessari

--account --automation-account-name

Nome dell'account di automazione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--filter

Il filtro da applicare all'operazione.

--inlinecount

Restituisce le righe totali.

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

--skip

Numero di righe da ignorare.

--top

Numero di righe da accettare.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az automation configuration show

Ottenere la configurazione identificata dal nome della configurazione.

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

Esempio

Ottenere la configurazione in base al nome

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

Parametri facoltativi

--account --automation-account-name

Nome dell'account di automazione.

--configuration-name --name -n

Nome della configurazione.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az automation configuration show-content

Ottenere lo script di configurazione identificato dal nome della configurazione.

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

Esempio

Visualizzare il contenuto dello script di configurazione DSC

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

Parametri facoltativi

--account --automation-account-name

Nome dell'account di automazione.

--configuration-name --name -n

Nome della configurazione.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az automation configuration update

Aggiornare la configurazione identificata dal nome della configurazione.

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]

Esempio

Aggiornare lo script nella configurazione 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"
}
}
}"

Parametri facoltativi

--account --automation-account-name

Nome dell'account di automazione.

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, stringa o stringa> JSON.

--configuration-name --name -n

Nome della configurazione.

--description

Ottiene o imposta la descrizione della configurazione.

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--location

Ottiene o imposta il percorso della risorsa.

--log-progress

Ottiene o imposta l'opzione del log di stato.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Ottiene o imposta l'opzione di log dettagliata.

valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Ottiene o imposta i parametri di configurazione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=.

--source

Ottiene o imposta il valore del contenuto. Si basa sul tipo di origine del contenuto.

--source-hash

Ottiene o imposta l'hash. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--source-type

Ottiene o imposta il tipo di origine del contenuto.

valori accettati: embeddedContent, uri
--source-version

Ottiene o imposta la versione del contenuto.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Ottiene o imposta i tag associati alla risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.