az automation configuration

Notitie

Deze verwijzing maakt deel uit van de automatiseringsextensie voor de Azure CLI (versie 2.55.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az automation-configuratieopdracht uitvoert. Meer informatie over extensies.

Dsc-configuratie beheren.

Opdracht

Name Description Type Status
az automation configuration create

Maak de configuratie die wordt geïdentificeerd door de configuratienaam.

Toestel GA
az automation configuration delete

Verwijder de dsc-configuratie die is geïdentificeerd door de configuratienaam.

Toestel GA
az automation configuration list

Een lijst met configuraties weergeven.

Toestel GA
az automation configuration show

Haal de configuratie op die wordt geïdentificeerd door de configuratienaam.

Toestel GA
az automation configuration show-content

Haal het configuratiescript op dat is geïdentificeerd door de configuratienaam.

Toestel GA
az automation configuration update

Werk de configuratie bij die wordt geïdentificeerd door de configuratienaam.

Toestel GA

az automation configuration create

Maak de configuratie die wordt geïdentificeerd door de configuratienaam.

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]

Voorbeelden

DSC-configuratie maken waarmee een server wordt ingesteld

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

Vereiste parameters

--account --automation-account-name

De naam van het Automation-account.

--configuration-name --name -n

De parameters voor het maken of bijwerken van de configuratie.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--description

Hiermee haalt u de beschrijving van de configuratie op of stelt u deze in.

--location

Hiermee wordt de locatie van de resource opgehaald of ingesteld.

--log-progress

Hiermee haalt u de optie voortgangslogboek op of stelt u deze in.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Hiermee haalt u uitgebreide logboekoptie op of stelt u deze in.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Hiermee haalt u de configuratieparameters op of stelt u deze in. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--source

Hiermee haalt u de waarde van de inhoud op of stelt u deze in. Dit is gebaseerd op het inhoudsbrontype.

--source-hash

Hiermee haalt u de hash op of stelt u deze in. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--source-type

Hiermee haalt u het inhoudsbrontype op of stelt u dit in.

geaccepteerde waarden: embeddedContent, uri
--source-version

Hiermee haalt u de versie van de inhoud op of stelt u deze in.

--tags

Hiermee haalt u de tags op die aan de resource zijn gekoppeld of stelt u deze in. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az automation configuration delete

Verwijder de dsc-configuratie die is geïdentificeerd door de configuratienaam.

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

Voorbeelden

De DSC-configuratie verwijderen

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

Optionele parameters

--account --automation-account-name

De naam van het Automation-account.

--configuration-name --name -n

De configuratienaam.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az automation configuration list

Een lijst met configuraties weergeven.

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

Voorbeelden

Alle DSC-configuraties weergeven

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

Vereiste parameters

--account --automation-account-name

De naam van het Automation-account.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--filter

Het filter dat op de bewerking moet worden toegepast.

--inlinecount

Totaalrijen retourneren.

--max-items

Totaal aantal items dat moet worden geretourneerd in de uitvoer van de opdracht. Als het totale aantal beschikbare items groter is dan de opgegeven waarde, wordt een token opgegeven in de uitvoer van de opdracht. Als u paginering wilt hervatten, geeft u de tokenwaarde op in --next-token het argument van een volgende opdracht.

--next-token

Token om op te geven waar paginering moet worden gestart. Dit is de tokenwaarde van een eerder afgekapt antwoord.

--skip

Het aantal rijen dat moet worden overgeslagen.

--top

Het aantal rijen dat moet worden uitgevoerd.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az automation configuration show

Haal de configuratie op die wordt geïdentificeerd door de configuratienaam.

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

Voorbeelden

De configuratie ophalen op basis van de naam

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

Optionele parameters

--account --automation-account-name

De naam van het Automation-account.

--configuration-name --name -n

De configuratienaam.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az automation configuration show-content

Haal het configuratiescript op dat is geïdentificeerd door de configuratienaam.

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

Voorbeelden

De scriptinhoud van DSC-configuratie weergeven

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

Optionele parameters

--account --automation-account-name

De naam van het Automation-account.

--configuration-name --name -n

De configuratienaam.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az automation configuration update

Werk de configuratie bij die wordt geïdentificeerd door de configuratienaam.

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]

Voorbeelden

Script bijwerken in DSC-configuratie

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

Optionele parameters

--account --automation-account-name

De naam van het Automation-account.

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string of JSON string>.

--configuration-name --name -n

De configuratienaam.

--description

Hiermee haalt u de beschrijving van de configuratie op of stelt u deze in.

--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--location

Hiermee wordt de locatie van de resource opgehaald of ingesteld.

--log-progress

Hiermee haalt u de optie voortgangslogboek op of stelt u deze in.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Hiermee haalt u uitgebreide logboekoptie op of stelt u deze in.

geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Hiermee haalt u de configuratieparameters op of stelt u deze in. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list OR --remove propertyToRemove.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=.

--source

Hiermee haalt u de waarde van de inhoud op of stelt u deze in. Dit is gebaseerd op het inhoudsbrontype.

--source-hash

Hiermee haalt u de hash op of stelt u deze in. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

--source-type

Hiermee haalt u het inhoudsbrontype op of stelt u dit in.

geaccepteerde waarden: embeddedContent, uri
--source-version

Hiermee haalt u de versie van de inhoud op of stelt u deze in.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--tags

Hiermee haalt u de tags op die aan de resource zijn gekoppeld of stelt u deze in. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
standaardwaarde: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.