az guestconfig guest-configuration-hcrp-assignment

Kommentar

Den här referensen är en del av gästkonfigurationstillägget för Azure CLI (version 2.3.1 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az guestconfig guest-configuration-hcrp-assignment . Läs mer om tillägg.

Den här kommandogruppen är experimentell och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Guestconfig guest-configuration-hcrp-assignment.

Kommandon

Name Description Typ Status
az guestconfig guest-configuration-hcrp-assignment create

Skapar en association mellan en ARC-dator och gästkonfiguration.

Anknytning Experimentell
az guestconfig guest-configuration-hcrp-assignment delete

Ta bort en gästkonfigurationstilldelning.

Anknytning Experimentell
az guestconfig guest-configuration-hcrp-assignment list

Visa en lista över alla gästkonfigurationstilldelningar för en ARC-dator.

Anknytning Experimentell
az guestconfig guest-configuration-hcrp-assignment show

Hämta information om en gästkonfigurationstilldelning.

Anknytning Experimentell
az guestconfig guest-configuration-hcrp-assignment update

Skapar en association mellan en ARC-dator och gästkonfiguration.

Anknytning Experimentell
az guestconfig guest-configuration-hcrp-assignment wait

Placera CLI i vänteläge tills ett villkor för gästkonfigurationen gästkonfiguration-hcrp-tilldelning har uppfyllts.

Anknytning Experimentell

az guestconfig guest-configuration-hcrp-assignment create

Experimentell

Kommandogruppen "guestconfig guest-configuration-hcrp-assignment" är experimentell och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapar en association mellan en ARC-dator och gästkonfiguration.

az guestconfig guest-configuration-hcrp-assignment create --guest-configuration-assignment-name
                                                          --machine-name
                                                          --resource-group
                                                          [--context]
                                                          [--guest-configuration-configuration-parameter]
                                                          [--guest-configuration-configuration-setting]
                                                          [--guest-configuration-name]
                                                          [--guest-configuration-version]
                                                          [--latest-assignment-report-assignment]
                                                          [--location]
                                                          [--name]
                                                          [--no-wait]

Exempel

Skapa eller uppdatera gästkonfigurationstilldelning

az guestconfig guest-configuration-hcrp-assignment create --guest-configuration-assignment-name "WhitelistedApplication" --machine-name "myMachineName" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName"

Obligatoriska parametrar

--guest-configuration-assignment-name

Namnet på gästkonfigurationstilldelningen.

--machine-name

Namnet på ARC-datorn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--context

Källan som initierade gästkonfigurationstilldelningen. Ex: Azure Policy.

--guest-configuration-configuration-parameter

Konfigurationsparametrarna för gästkonfigurationen.

Användning: --guest-configuration-configuration-parameter name=XX value=XX

name: Namnet på konfigurationsparametern. värde: Värdet för konfigurationsparametern.

Flera åtgärder kan anges med hjälp av fler än ett --guest-configuration-configuration-parameter-argument.

--guest-configuration-configuration-setting

Konfigurationsinställningen för gästkonfigurationen.

Användning: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX

configuration-mode: Anger hur LCM(Local Configuration Manager) faktiskt tillämpar konfigurationen på målnoderna. Möjliga värden är ApplyOnly, ApplyAndMonitor och ApplyAndAutoCorrect. allow-module-overwrite: Om sant – nya konfigurationer som laddats ned från pull-tjänsten tillåts skriva över de gamla på målnoden. Annars false action-after-reboot: Anger vad som händer efter en omstart under tillämpningen av en konfiguration. Möjliga värden är ContinueConfiguration och StopConfiguration refresh-frequency-mins: Tidsintervallet, i minuter, där LCM kontrollerar en pull-tjänst för att få uppdaterade konfigurationer. Det här värdet ignoreras om LCM inte har konfigurerats i pull-läge. Standardvärdet är 30. reboot-if-needed: Ställ in detta på true för att automatiskt starta om noden efter att en konfiguration som kräver omstart har tillämpats. Annars måste du starta om noden manuellt för alla konfigurationer som kräver den. Standardvärdet är "false". Om du vill använda den här inställningen när ett omstartsvillkor utförs av något annat än DSC (till exempel Windows Installer) kombinerar du den här inställningen med modulen xPendingReboot. configuration-mode-frequency-mins: Hur ofta, på några minuter, kontrolleras och tillämpas den aktuella konfigurationen. Den här egenskapen ignoreras om egenskapen ConfigurationMode är inställd på ApplyOnly. Standardvärdet är 15.

--guest-configuration-name

Namnet på gästkonfigurationen.

--guest-configuration-version

Version av gästkonfigurationen.

--latest-assignment-report-assignment

Konfigurationsinformation för gästkonfigurationstilldelningen. Förväntat värde: json-string/@json-file.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--name

Namnet på gästkonfigurationstilldelningen.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az guestconfig guest-configuration-hcrp-assignment delete

Experimentell

Kommandogruppen "guestconfig guest-configuration-hcrp-assignment" är experimentell och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Ta bort en gästkonfigurationstilldelning.

az guestconfig guest-configuration-hcrp-assignment delete [--guest-configuration-assignment-name]
                                                          [--ids]
                                                          [--machine-name]
                                                          [--no-wait]
                                                          [--resource-group]
                                                          [--subscription]

Exempel

Ta bort en gästkonfigurationstilldelning

az guestconfig guest-configuration-hcrp-assignment delete --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName"

Valfria parametrar

--guest-configuration-assignment-name

Namnet på gästkonfigurationstilldelningen.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--machine-name

Namnet på ARC-datorn.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az guestconfig guest-configuration-hcrp-assignment list

Experimentell

Kommandogruppen "guestconfig guest-configuration-hcrp-assignment" är experimentell och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Visa en lista över alla gästkonfigurationstilldelningar för en ARC-dator.

az guestconfig guest-configuration-hcrp-assignment list --machine-name
                                                        --resource-group

Exempel

Visa en lista över alla gästkonfigurationstilldelningar för en virtuell dator

az guestconfig guest-configuration-hcrp-assignment list --machine-name "myMachineName" --resource-group "myResourceGroupName"

Obligatoriska parametrar

--machine-name

Namnet på ARC-datorn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az guestconfig guest-configuration-hcrp-assignment show

Experimentell

Kommandogruppen "guestconfig guest-configuration-hcrp-assignment" är experimentell och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hämta information om en gästkonfigurationstilldelning.

az guestconfig guest-configuration-hcrp-assignment show [--guest-configuration-assignment-name]
                                                        [--ids]
                                                        [--machine-name]
                                                        [--resource-group]
                                                        [--subscription]

Exempel

Hämta en gästkonfigurationstilldelning

az guestconfig guest-configuration-hcrp-assignment show --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName"

Valfria parametrar

--guest-configuration-assignment-name

Namnet på gästkonfigurationstilldelningen.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--machine-name

Namnet på ARC-datorn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az guestconfig guest-configuration-hcrp-assignment update

Experimentell

Kommandogruppen "guestconfig guest-configuration-hcrp-assignment" är experimentell och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapar en association mellan en ARC-dator och gästkonfiguration.

az guestconfig guest-configuration-hcrp-assignment update [--context]
                                                          [--guest-configuration-assignment-name]
                                                          [--guest-configuration-configuration-parameter]
                                                          [--guest-configuration-configuration-setting]
                                                          [--guest-configuration-name]
                                                          [--guest-configuration-version]
                                                          [--ids]
                                                          [--latest-assignment-report-assignment]
                                                          [--location]
                                                          [--machine-name]
                                                          [--name]
                                                          [--no-wait]
                                                          [--resource-group]
                                                          [--subscription]

Exempel

Skapa eller uppdatera gästkonfigurationstilldelning

az guestconfig guest-configuration-hcrp-assignment update --guest-configuration-assignment-name "WhitelistedApplication" --machine-name "myMachineName" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName"

Valfria parametrar

--context

Källan som initierade gästkonfigurationstilldelningen. Ex: Azure Policy.

--guest-configuration-assignment-name

Namnet på gästkonfigurationstilldelningen.

--guest-configuration-configuration-parameter

Konfigurationsparametrarna för gästkonfigurationen.

Användning: --guest-configuration-configuration-parameter name=XX value=XX

name: Namnet på konfigurationsparametern. värde: Värdet för konfigurationsparametern.

Flera åtgärder kan anges med hjälp av fler än ett --guest-configuration-configuration-parameter-argument.

--guest-configuration-configuration-setting

Konfigurationsinställningen för gästkonfigurationen.

Användning: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX

configuration-mode: Anger hur LCM(Local Configuration Manager) faktiskt tillämpar konfigurationen på målnoderna. Möjliga värden är ApplyOnly, ApplyAndMonitor och ApplyAndAutoCorrect. allow-module-overwrite: Om sant – nya konfigurationer som laddats ned från pull-tjänsten tillåts skriva över de gamla på målnoden. Annars false action-after-reboot: Anger vad som händer efter en omstart under tillämpningen av en konfiguration. Möjliga värden är ContinueConfiguration och StopConfiguration refresh-frequency-mins: Tidsintervallet, i minuter, där LCM kontrollerar en pull-tjänst för att få uppdaterade konfigurationer. Det här värdet ignoreras om LCM inte har konfigurerats i pull-läge. Standardvärdet är 30. reboot-if-needed: Ställ in detta på true för att automatiskt starta om noden efter att en konfiguration som kräver omstart har tillämpats. Annars måste du starta om noden manuellt för alla konfigurationer som kräver den. Standardvärdet är "false". Om du vill använda den här inställningen när ett omstartsvillkor utförs av något annat än DSC (till exempel Windows Installer) kombinerar du den här inställningen med modulen xPendingReboot. configuration-mode-frequency-mins: Hur ofta, på några minuter, kontrolleras och tillämpas den aktuella konfigurationen. Den här egenskapen ignoreras om egenskapen ConfigurationMode är inställd på ApplyOnly. Standardvärdet är 15.

--guest-configuration-name

Namnet på gästkonfigurationen.

--guest-configuration-version

Version av gästkonfigurationen.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--latest-assignment-report-assignment

Konfigurationsinformation för gästkonfigurationstilldelningen. Förväntat värde: json-string/@json-file.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--machine-name

Namnet på ARC-datorn.

--name

Namnet på gästkonfigurationstilldelningen.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az guestconfig guest-configuration-hcrp-assignment wait

Experimentell

Kommandogruppen "guestconfig guest-configuration-hcrp-assignment" är experimentell och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Placera CLI i vänteläge tills ett villkor för gästkonfigurationen gästkonfiguration-hcrp-tilldelning har uppfyllts.

az guestconfig guest-configuration-hcrp-assignment wait [--created]
                                                        [--custom]
                                                        [--deleted]
                                                        [--exists]
                                                        [--guest-configuration-assignment-name]
                                                        [--ids]
                                                        [--interval]
                                                        [--machine-name]
                                                        [--resource-group]
                                                        [--subscription]
                                                        [--timeout]
                                                        [--updated]

Exempel

Pausa körningen av nästa rad i CLI-skriptet tills gästkonfigurations-hcrp-tilldelningen har skapats.

az guestconfig guest-configuration-hcrp-assignment wait --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName" --created

Pausa körningen av nästa rad i CLI-skriptet tills gästkonfigurations-hcrp-tilldelningen har tagits bort.

az guestconfig guest-configuration-hcrp-assignment wait --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName" --deleted

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--guest-configuration-assignment-name

Namnet på gästkonfigurationstilldelningen.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--machine-name

Namnet på ARC-datorn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.