Udostępnij za pośrednictwem

az guestconfig guest-configuration-hcrp-assignment

  • Eksperymentalne
  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia guestconfig dla interfejsu wiersza polecenia platformy Azure (wersja 2.3.1 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az guestconfig guest-configuration-hcrp-assignment po raz pierwszy. Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest eksperymentalna i opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Guestconfig guest-configuration-hcrp-assignment.

Polecenia

Nazwa Opis Typ Stan
az guestconfig guest-configuration-hcrp-assignment create

Tworzy skojarzenie między maszyną ARC i konfiguracją gościa.

 Numer wewnętrzny Eksperymentalne
az guestconfig guest-configuration-hcrp-assignment delete

Usuń przypisanie konfiguracji gościa.

 Numer wewnętrzny Eksperymentalne
az guestconfig guest-configuration-hcrp-assignment list

Wyświetl listę wszystkich przypisań konfiguracji gościa dla maszyny ARC.

 Numer wewnętrzny Eksperymentalne
az guestconfig guest-configuration-hcrp-assignment show

Uzyskaj informacje o przypisaniu konfiguracji gościa.

 Numer wewnętrzny Eksperymentalne
az guestconfig guest-configuration-hcrp-assignment update

Tworzy skojarzenie między maszyną ARC i konfiguracją gościa.

 Numer wewnętrzny Eksperymentalne
az guestconfig guest-configuration-hcrp-assignment wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku ustawienia guestconfig guest-configuration-hcrp-assignment.

 Numer wewnętrzny Eksperymentalne

az guestconfig guest-configuration-hcrp-assignment create

Eksperymentalne

Grupa poleceń "guestconfig guest-configuration-hcrp-assignment" jest eksperymentalna i opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Tworzy skojarzenie między maszyną ARC i konfiguracją gościa.

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]

Przykłady

Tworzenie lub aktualizowanie przypisania konfiguracji gościa

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"

Parametry wymagane

--guest-configuration-assignment-name

Nazwa przypisania konfiguracji gościa.

--machine-name

Nazwa maszyny ARC.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry opcjonalne

--context

Źródło, które zainicjowało przypisanie konfiguracji gościa. Na przykład: Azure Policy.

--guest-configuration-configuration-parameter

Parametry konfiguracji dla konfiguracji gościa.

Użycie: --guest-configuration-configuration-parameter name=XX value=XX

name: nazwa parametru konfiguracji. value: Wartość parametru konfiguracji.

Wiele akcji można określić za pomocą więcej niż jednego argumentu --guest-configuration-configuration-parameter.

--guest-configuration-configuration-setting

Ustawienie konfiguracji dla konfiguracji gościa.

Użycie: --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

tryb konfiguracji: określa, jak LCM(Local Configuration Manager) rzeczywiście stosuje konfigurację do węzłów docelowych. Możliwe wartości to ApplyOnly, ApplyAndMonitor i ApplyAndAutoCorrect. allow-module-overwrite: jeśli prawda — nowe konfiguracje pobrane z usługi ściągania mogą zastąpić stare w węźle docelowym. W przeciwnym razie wartość false action-after-reboot: określa, co się dzieje po ponownym uruchomieniu podczas stosowania konfiguracji. Możliwe wartości to ContinueConfiguration i StopConfiguration refresh-frequency-mins: interwał czasu w minutach, w których LCM sprawdza usługę ściągania w celu uzyskania zaktualizowanych konfiguracji. Ta wartość jest ignorowana, jeśli funkcja LCM nie jest skonfigurowana w trybie ściągania. Wartość domyślna to 30. reboot-if-needed: ustaw tę wartość na true, aby automatycznie ponownie uruchomić węzeł po zastosowaniu konfiguracji wymagającej ponownego uruchomienia. W przeciwnym razie konieczne będzie ręczne ponowne uruchomienie węzła dla każdej wymaganej konfiguracji. Wartość domyślna to false. Aby użyć tego ustawienia, gdy warunek ponownego uruchomienia zostanie uchwalony przez coś innego niż DSC (np. Instalator Windows), połącz to ustawienie z modułem xPendingReboot. configuration-mode-frequency-mins: Jak często, w minutach, bieżąca konfiguracja jest sprawdzana i stosowana. Ta właściwość jest ignorowana, jeśli właściwość ConfigurationMode jest ustawiona na ApplyOnly. Wartość domyślna to 15.

--guest-configuration-name

Nazwa konfiguracji gościa.

--guest-configuration-version

Wersja konfiguracji gościa.

--latest-assignment-report-assignment

Szczegóły konfiguracji przypisania konfiguracji gościa. Oczekiwana wartość: json-string/@json-file.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--name

Nazwa przypisania konfiguracji gościa.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az guestconfig guest-configuration-hcrp-assignment delete

Eksperymentalne

Grupa poleceń "guestconfig guest-configuration-hcrp-assignment" jest eksperymentalna i opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Usuń przypisanie konfiguracji gościa.

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

Przykłady

Usuwanie przypisania konfiguracji gościa

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

Parametry opcjonalne

--guest-configuration-assignment-name

Nazwa przypisania konfiguracji gościa.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--machine-name

Nazwa maszyny ARC.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az guestconfig guest-configuration-hcrp-assignment list

Eksperymentalne

Grupa poleceń "guestconfig guest-configuration-hcrp-assignment" jest eksperymentalna i opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Wyświetl listę wszystkich przypisań konfiguracji gościa dla maszyny ARC.

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

Przykłady

Wyświetlanie listy wszystkich przypisań konfiguracji gościa dla maszyny wirtualnej

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

Parametry wymagane

--machine-name

Nazwa maszyny ARC.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az guestconfig guest-configuration-hcrp-assignment show

Eksperymentalne

Grupa poleceń "guestconfig guest-configuration-hcrp-assignment" jest eksperymentalna i opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Uzyskaj informacje o przypisaniu konfiguracji gościa.

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

Przykłady

Uzyskiwanie przypisania konfiguracji gościa

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

Parametry opcjonalne

--guest-configuration-assignment-name

Nazwa przypisania konfiguracji gościa.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--machine-name

Nazwa maszyny ARC.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az guestconfig guest-configuration-hcrp-assignment update

Eksperymentalne

Grupa poleceń "guestconfig guest-configuration-hcrp-assignment" jest eksperymentalna i opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Tworzy skojarzenie między maszyną ARC i konfiguracją gościa.

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]

Przykłady

Tworzenie lub aktualizowanie przypisania konfiguracji gościa

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"

Parametry opcjonalne

--context

Źródło, które zainicjowało przypisanie konfiguracji gościa. Na przykład: Azure Policy.

--guest-configuration-assignment-name

Nazwa przypisania konfiguracji gościa.

--guest-configuration-configuration-parameter

Parametry konfiguracji dla konfiguracji gościa.

Użycie: --guest-configuration-configuration-parameter name=XX value=XX

name: nazwa parametru konfiguracji. value: Wartość parametru konfiguracji.

Wiele akcji można określić za pomocą więcej niż jednego argumentu --guest-configuration-configuration-parameter.

--guest-configuration-configuration-setting

Ustawienie konfiguracji dla konfiguracji gościa.

Użycie: --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

tryb konfiguracji: określa, jak LCM(Local Configuration Manager) rzeczywiście stosuje konfigurację do węzłów docelowych. Możliwe wartości to ApplyOnly, ApplyAndMonitor i ApplyAndAutoCorrect. allow-module-overwrite: jeśli prawda — nowe konfiguracje pobrane z usługi ściągania mogą zastąpić stare w węźle docelowym. W przeciwnym razie wartość false action-after-reboot: określa, co się dzieje po ponownym uruchomieniu podczas stosowania konfiguracji. Możliwe wartości to ContinueConfiguration i StopConfiguration refresh-frequency-mins: interwał czasu w minutach, w których LCM sprawdza usługę ściągania w celu uzyskania zaktualizowanych konfiguracji. Ta wartość jest ignorowana, jeśli funkcja LCM nie jest skonfigurowana w trybie ściągania. Wartość domyślna to 30. reboot-if-needed: ustaw tę wartość na true, aby automatycznie ponownie uruchomić węzeł po zastosowaniu konfiguracji wymagającej ponownego uruchomienia. W przeciwnym razie konieczne będzie ręczne ponowne uruchomienie węzła dla każdej wymaganej konfiguracji. Wartość domyślna to false. Aby użyć tego ustawienia, gdy warunek ponownego uruchomienia zostanie uchwalony przez coś innego niż DSC (np. Instalator Windows), połącz to ustawienie z modułem xPendingReboot. configuration-mode-frequency-mins: Jak często, w minutach, bieżąca konfiguracja jest sprawdzana i stosowana. Ta właściwość jest ignorowana, jeśli właściwość ConfigurationMode jest ustawiona na ApplyOnly. Wartość domyślna to 15.

--guest-configuration-name

Nazwa konfiguracji gościa.

--guest-configuration-version

Wersja konfiguracji gościa.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--latest-assignment-report-assignment

Szczegóły konfiguracji przypisania konfiguracji gościa. Oczekiwana wartość: json-string/@json-file.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--machine-name

Nazwa maszyny ARC.

--name

Nazwa przypisania konfiguracji gościa.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az guestconfig guest-configuration-hcrp-assignment wait

Eksperymentalne

Grupa poleceń "guestconfig guest-configuration-hcrp-assignment" jest eksperymentalna i opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku ustawienia guestconfig guest-configuration-hcrp-assignment.

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

Przykłady

Wstrzymaj wykonywanie następnego wiersza polecenia skryptu interfejsu wiersza polecenia do momentu pomyślnego utworzenia polecenia guestconfig guest-configuration-hcrp-assignment.

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

Wstrzymaj wykonywanie następnego wiersza polecenia skryptu interfejsu wiersza polecenia do momentu pomyślnego usunięcia polecenia guestconfig guest-configuration-hcrp-assignment.

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

Parametry opcjonalne

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

wartość domyślna: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Poczekaj na usunięcie.

wartość domyślna: False
--exists

Zaczekaj, aż zasób istnieje.

wartość domyślna: False
--guest-configuration-assignment-name

Nazwa przypisania konfiguracji gościa.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być pełny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--interval

Interwał sondowania w sekundach.

wartość domyślna: 30
--machine-name

Nazwa maszyny ARC.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.