Sdílet prostřednictvím

az guestconfig guest-configuration-assignment

  • Experimentální
  • Reference

Poznámka

Tento odkaz je součástí rozšíření hostconfig pro Azure CLI (verze 2.3.1 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az guestconfig guest-configuration-assignment . Přečtěte si další informace o rozšířeních.

Tato skupina příkazů je experimentální a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Hostconfig guest-configuration-assignment.

Příkazy

Name Description Typ Stav
az guestconfig guest-configuration-assignment create

Vytvoří přidružení mezi virtuálním počítačem a konfigurací hosta.

 Rozšíření Experimentální
az guestconfig guest-configuration-assignment delete

Odstraňte přiřazení konfigurace hosta.

 Rozšíření Experimentální
az guestconfig guest-configuration-assignment list

Zobrazí seznam všech přiřazení konfigurace hosta pro virtuální počítač.

 Rozšíření Experimentální
az guestconfig guest-configuration-assignment show

Získejte informace o přiřazení konfigurace hosta.

 Rozšíření Experimentální
az guestconfig guest-configuration-assignment update

Vytvoří přidružení mezi virtuálním počítačem a konfigurací hosta.

 Rozšíření Experimentální
az guestconfig guest-configuration-assignment wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka hostconfig host-configuration-assignment.

 Rozšíření Experimentální

az guestconfig guest-configuration-assignment create

Experimentální

Skupina příkazů guestconfig guest-configuration-assignment je experimentální a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Vytvoří přidružení mezi virtuálním počítačem a konfigurací hosta.

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

Příklady

Vytvoření nebo aktualizace přiřazení konfigurace hosta

az guestconfig guest-configuration-assignment create --guest-configuration-assignment-name "WhitelistedApplication" --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" --vm-name "myVMName"

Povinné parametry

--guest-configuration-assignment-name

Název přiřazení konfigurace hosta.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--vm-name

Název virtuálního počítače.

Volitelné parametry

--context

Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy.

--guest-configuration-configuration-parameter

Parametry konfigurace pro konfiguraci hosta.

Použití: --guest-configuration-configuration-parameter name=XX value=XX

name: Název parametru konfigurace. value: Hodnota parametru konfigurace.

Pomocí více než jednoho argumentu parametru --guest-configuration-configuration-configuration-parameter je možné zadat více akcí.

--guest-configuration-configuration-setting

Nastavení konfigurace pro konfiguraci hosta.

Použití: --guest-configuration-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

režim konfigurace: Určuje, jak LCM(Local Configuration Manager) skutečně použije konfiguraci na cílové uzly. Možné hodnoty jsou ApplyOnly, ApplyAndMonitor a ApplyAndAutoCorrect. allow-module-overwrite: Pokud je true – nové konfigurace stažené ze služby vyžádané replikace mohou přepsat staré konfigurace v cílovém uzlu. V opačném případě nepravda akce po restartování: Určuje, co se stane po restartování během aplikace konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration refresh-frequency-mins: Časový interval v minutách, ve kterém LCM kontroluje službu vyžádané replikace, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud není LCM nakonfigurovaný v režimu vyžádání obsahu. Výchozí hodnota je 30. reboot-if-needed: Nastavte tuto hodnotu na true pro automatické restartování uzlu po konfiguraci, která vyžaduje restartování je použita. Jinak budete muset ručně restartovat uzel pro všechny konfigurace, které ho vyžadují. Výchozí hodnota je false. Chcete-li toto nastavení použít, pokud je podmínka restartování přijata něčím jiným než DSC (například Instalační služba systému Windows), zkombinujte toto nastavení s modulem xPendingReboot. configuration-mode-frequency-mins: How often, in minutes, the current configuration is checked and applied. Tato vlastnost se ignoruje, pokud je vlastnost ConfigurationMode nastavena na ApplyOnly. Výchozí hodnota je 15.

--guest-configuration-name

Název konfigurace hosta

--guest-configuration-version

Verze konfigurace hosta

--latest-assignment-report-assignment

Podrobnosti o konfiguraci hosta Očekávaná hodnota: json-string/@json-file.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--name

Název přiřazení konfigurace hosta.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az guestconfig guest-configuration-assignment delete

Experimentální

Skupina příkazů guestconfig guest-configuration-assignment je experimentální a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Odstraňte přiřazení konfigurace hosta.

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

Příklady

Odstranění přiřazení konfigurace hosta

az guestconfig guest-configuration-assignment delete --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název přiřazení konfigurace hosta.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az guestconfig guest-configuration-assignment list

Experimentální

Skupina příkazů guestconfig guest-configuration-assignment je experimentální a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Zobrazí seznam všech přiřazení konfigurace hosta pro virtuální počítač.

az guestconfig guest-configuration-assignment list --resource-group
                                                   --vm-name

Příklady

Výpis všech přiřazení konfigurace hosta pro virtuální počítač

az guestconfig guest-configuration-assignment list --resource-group "myResourceGroupName" --vm-name "myVMName"

Povinné parametry

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az guestconfig guest-configuration-assignment show

Experimentální

Skupina příkazů guestconfig guest-configuration-assignment je experimentální a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Získejte informace o přiřazení konfigurace hosta.

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

Příklady

Získání přiřazení konfigurace hosta

az guestconfig guest-configuration-assignment show --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název přiřazení konfigurace hosta.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az guestconfig guest-configuration-assignment update

Experimentální

Skupina příkazů guestconfig guest-configuration-assignment je experimentální a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Vytvoří přidružení mezi virtuálním počítačem a konfigurací hosta.

az guestconfig guest-configuration-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]
                                                     [--name]
                                                     [--no-wait]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--vm-name]

Příklady

Vytvoření nebo aktualizace přiřazení konfigurace hosta

az guestconfig guest-configuration-assignment update --guest-configuration-assignment-name "WhitelistedApplication" --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" --vm-name "myVMName"

Volitelné parametry

--context

Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy.

--guest-configuration-assignment-name

Název přiřazení konfigurace hosta.

--guest-configuration-configuration-parameter

Parametry konfigurace pro konfiguraci hosta.

Použití: --guest-configuration-configuration-parameter name=XX value=XX

name: Název parametru konfigurace. value: Hodnota parametru konfigurace.

Pomocí více než jednoho argumentu parametru --guest-configuration-configuration-configuration-parameter je možné zadat více akcí.

--guest-configuration-configuration-setting

Nastavení konfigurace pro konfiguraci hosta.

Použití: --guest-configuration-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

režim konfigurace: Určuje, jak LCM(Local Configuration Manager) skutečně použije konfiguraci na cílové uzly. Možné hodnoty jsou ApplyOnly, ApplyAndMonitor a ApplyAndAutoCorrect. allow-module-overwrite: Pokud je true – nové konfigurace stažené ze služby vyžádané replikace mohou přepsat staré konfigurace v cílovém uzlu. V opačném případě nepravda akce po restartování: Určuje, co se stane po restartování během aplikace konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration refresh-frequency-mins: Časový interval v minutách, ve kterém LCM kontroluje službu vyžádané replikace, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud není LCM nakonfigurovaný v režimu vyžádání obsahu. Výchozí hodnota je 30. reboot-if-needed: Nastavte tuto hodnotu na true pro automatické restartování uzlu po konfiguraci, která vyžaduje restartování je použita. Jinak budete muset ručně restartovat uzel pro všechny konfigurace, které ho vyžadují. Výchozí hodnota je false. Chcete-li toto nastavení použít, pokud je podmínka restartování přijata něčím jiným než DSC (například Instalační služba systému Windows), zkombinujte toto nastavení s modulem xPendingReboot. configuration-mode-frequency-mins: How often, in minutes, the current configuration is checked and applied. Tato vlastnost se ignoruje, pokud je vlastnost ConfigurationMode nastavena na ApplyOnly. Výchozí hodnota je 15.

--guest-configuration-name

Název konfigurace hosta

--guest-configuration-version

Verze konfigurace hosta

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--latest-assignment-report-assignment

Podrobnosti o konfiguraci hosta Očekávaná hodnota: json-string/@json-file.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--name

Název přiřazení konfigurace hosta.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az guestconfig guest-configuration-assignment wait

Experimentální

Skupina příkazů guestconfig guest-configuration-assignment je experimentální a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka hostconfig host-configuration-assignment.

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

Příklady

Pozastavte provádění dalšího řádku skriptu rozhraní příkazového řádku, dokud se úspěšně nevytvořilo přiřazení konfigurace hosta hosta.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --created

Pozastavte provádění dalšího řádku skriptu rozhraní příkazového řádku, dokud se úspěšně neskonfiguruje přiřazení konfigurace hosta.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --deleted

Volitelné parametry

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Default value: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

Default value: False
--exists

Počkejte, až prostředek existuje.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--interval

Interval dotazování v sekundách

Default value: 30
--name -n

Název přiřazení konfigurace hosta.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--timeout

Maximální čekání v sekundách.

Default value: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Default value: False
--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.