az connectedmachine extension

Uwaga

Ta dokumentacja jest częścią rozszerzenia connectedmachine dla interfejsu wiersza polecenia platformy Azure (wersja 2.15.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az connectedmachine extension . Dowiedz się więcej o rozszerzeniach.

Zarządzanie rozszerzeniem maszyny za pomocą maszyny connectedmachine.

Polecenia

az connectedmachine extension create	Operacja tworzenia rozszerzenia.
az connectedmachine extension delete	Operacja usuwania rozszerzenia.
az connectedmachine extension list	Operacja pobierania wszystkich rozszerzeń maszyny spoza platformy Azure.
az connectedmachine extension show	Operacja pobierania rozszerzenia.
az connectedmachine extension update	Operacja tworzenia lub aktualizowania rozszerzenia.
az connectedmachine extension wait	Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku rozszerzenia connectedmachine.

az connectedmachine extension create

Operacja tworzenia rozszerzenia.

az connectedmachine extension create --machine-name
                                     --name
                                     --resource-group
                                     [--auto-upgrade-minor {false, true}]
                                     [--enable-auto-upgrade {false, true}]
                                     [--force-update-tag]
                                     [--inst-handler-version]
                                     [--instance-view-type]
                                     [--location]
                                     [--no-wait]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--status]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Przykłady

Tworzenie lub aktualizowanie rozszerzenia maszyny

az connectedmachine extension create --name "CustomScriptExtension" --location "eastus2euap" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings '{"commandToExecute":"hostname"}' --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Parametry wymagane

--machine-name

Nazwa maszyny, na której ma zostać utworzone lub zaktualizowane rozszerzenie.

--name

Nazwa rozszerzenia maszyny.

--resource-group -g

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

Parametry opcjonalne

--auto-upgrade-minor

Określ, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.

akceptowane wartości: false, true

--enable-auto-upgrade

Określ, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja.

akceptowane wartości: false, true

--force-update-tag

Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.

--inst-handler-version

Określ wersję programu obsługi skryptów.

--instance-view-type

Określ typ rozszerzenia; przykładem jest "CustomScriptExtension".

--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>.

--no-wait

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

--protected-settings

Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. Oczekiwana wartość: json-string/json-file/@json-file.

--publisher

Nazwa wydawcy programu obsługi rozszerzeń.

--settings

Formatowane ustawienia publiczne w formacie JSON dla rozszerzenia. Oczekiwana wartość: json-string/json-file/@json-file.

--status

Stan widoku wystąpienia.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--type

Określ typ rozszerzenia; przykładem jest "CustomScriptExtension".

--type-handler-version

Określ wersję programu obsługi skryptów.

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az connectedmachine extension delete

Operacja usuwania rozszerzenia.

az connectedmachine extension delete --machine-name
                                     --name
                                     --resource-group
                                     [--no-wait]
                                     [--yes]

Przykłady

Usuwanie rozszerzenia maszyny

az connectedmachine extension delete --name "MMA" --machine-name "myMachine" --resource-group "myResourceGroup"

Parametry wymagane

--machine-name

Nazwa maszyny, na której ma zostać usunięte rozszerzenie.

--name

Nazwa rozszerzenia maszyny.

--resource-group -g

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

Parametry opcjonalne

--no-wait

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

--yes -y

Nie monituj o potwierdzenie.

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az connectedmachine extension list

Operacja pobierania wszystkich rozszerzeń maszyny spoza platformy Azure.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]

Przykłady

Pobieranie wszystkich rozszerzeń maszyny

az connectedmachine extension list --machine-name "myMachine" --resource-group "myResourceGroup"

Parametry wymagane

--machine-name

Nazwa maszyny zawierającej rozszerzenie.

--resource-group -g

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

Parametry opcjonalne

--expand

Wyrażenie expand, które ma być stosowane do operacji.

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az connectedmachine extension show

Operacja pobierania rozszerzenia.

az connectedmachine extension show --machine-name
                                   --name
                                   --resource-group

Przykłady

Pobieranie rozszerzenia maszyny

az connectedmachine extension show --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup"

Parametry wymagane

--machine-name

Nazwa maszyny zawierającej rozszerzenie.

--name

Nazwa rozszerzenia maszyny.

--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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az connectedmachine extension update

Operacja tworzenia lub aktualizowania rozszerzenia.

az connectedmachine extension update --machine-name
                                     --name
                                     --resource-group
                                     [--auto-upgrade-minor {false, true}]
                                     [--enable-auto-upgrade {false, true}]
                                     [--force-update-tag]
                                     [--no-wait]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Przykłady

Tworzenie lub aktualizowanie rozszerzenia maszyny

az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings '{"commandToExecute":"hostname"}' --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Parametry wymagane

--machine-name

Nazwa maszyny, na której ma zostać utworzone lub zaktualizowane rozszerzenie.

--name

Nazwa rozszerzenia maszyny.

--resource-group -g

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

Parametry opcjonalne

--auto-upgrade-minor

Określ, czy rozszerzenie powinno używać nowszej wersji pomocniczej, jeśli jest ona dostępna w czasie wdrażania. Po wdrożeniu rozszerzenie nie uaktualni wersji pomocniczych, chyba że zostanie ponownie wdrożone, nawet jeśli ta właściwość ma wartość true.

akceptowane wartości: false, true

--enable-auto-upgrade

Określ, czy rozszerzenie powinno zostać automatycznie uaktualnione przez platformę, jeśli jest dostępna nowsza wersja.

akceptowane wartości: false, true

--force-update-tag

Sposób, w jaki program obsługi rozszerzeń powinien zostać zmuszony do aktualizacji, nawet jeśli konfiguracja rozszerzenia nie uległa zmianie.

--no-wait

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

--protected-settings

Rozszerzenie może zawierać ustawienia protectedSettings lub protectedSettingsFromKeyVault lub w ogóle nie są chronione. Oczekiwana wartość: json-string/json-file/@json-file.

--publisher

Nazwa wydawcy programu obsługi rozszerzeń.

--settings

Formatowane ustawienia publiczne w formacie JSON dla rozszerzenia. Oczekiwana wartość: json-string/json-file/@json-file.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--type

Określ typ rozszerzenia; przykładem jest "CustomScriptExtension".

--type-handler-version

Określ wersję programu obsługi skryptów.

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az connectedmachine extension wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku rozszerzenia connectedmachine.

az connectedmachine extension wait --machine-name
                                   --name
                                   --resource-group
                                   [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--interval]
                                   [--timeout]
                                   [--updated]

Przykłady

Wstrzymaj wykonywanie następnego wiersza skryptu interfejsu wiersza polecenia do momentu pomyślnego utworzenia rozszerzenia connectedmachine.

az connectedmachine extension wait --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup" --created

Wstrzymaj wykonywanie następnego wiersza skryptu interfejsu wiersza polecenia do momentu pomyślnego zaktualizowania rozszerzenia connectedmachine.

az connectedmachine extension wait --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup" --updated

Wstrzymaj wykonywanie następnego wiersza skryptu interfejsu wiersza polecenia do momentu pomyślnego usunięcia rozszerzenia connectedmachine.

az connectedmachine extension wait --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup" --deleted

Parametry wymagane

--machine-name

Nazwa maszyny zawierającej rozszerzenie.

--name

Nazwa rozszerzenia maszyny.

--resource-group -g

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

Parametry opcjonalne

--created

Zaczekaj na utworzenie polecenia "provisioningState" w lokalizacji "Succeeded".

--custom

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

--deleted

Zaczekaj na usunięcie.

--exists

Zaczekaj, aż zasób istnieje.

--interval

Interwał sondowania w sekundach.

wartość domyślna: 30

--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600

--updated

Zaczekaj na zaktualizowanie parametru provisioningState o godzinie "Succeeded".

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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.