Udostępnij przez


dokumentacja interfejsu wiersza polecenia azcmagent

Narzędzie wiersza polecenia agenta połączonej maszyny platformy Azure, azcmagent, ułatwia konfigurowanie połączenia serwera z usługą Azure Arc oraz zarządzanie nim oraz rozwiązywanie problemów z nim. Interfejs azcmagent wiersza polecenia jest instalowany za pomocą agenta połączonej maszyny platformy Azure i kontroluje akcje specyficzne dla serwera, na którym jest uruchomiony. Po połączeniu serwera z usługą Azure Arc możesz użyć interfejsu wiersza polecenia platformy Azure lub modułu Azure PowerShell , aby włączyć rozszerzenia, zarządzać tagami i wykonywać inne operacje na zasobie serwera.

Jeśli nie określono inaczej, składnia poleceń i flagi reprezentują dostępne opcje w najnowszej wersji agenta połączonej maszyny platformy Azure. Aby uzyskać więcej informacji, zobacz What's new with the Azure Connected Machine agent (Co nowego w agencie połączonej maszyny platformy Azure).

Aby uzyskać szczegółowe informacje o poszczególnych poleceniach dostępnych w interfejsie azcmagent wiersza polecenia, uruchom polecenie azcmagent COMMANDNAME --help lub zapoznaj się z następującymi stronami referencyjnymi:

Polecenia

Polecenie Przeznaczenie
azcmagent check Uruchamianie kontroli łączności sieciowej dla punktów końcowych usługi Azure Arc
azcmagent config Zarządzanie ustawieniami agenta.
azcmagent connect Połącz serwer z usługą Azure Arc.
azcmagent disconnect Odłącz serwer od usługi Azure Arc.
azcmagent genkey Wygeneruj parę kluczy publiczny-prywatny na potrzeby dołączania asynchronicznego.
azcmagent help Uzyskaj pomoc dotyczącą poleceń.
azcmagent license Wyświetl umowę licencyjną użytkownika końcowego.
azcmagent logs Zbieranie dzienników w celu rozwiązywania problemów z agentem.
azcmagent show Wyświetl stan agenta.
azcmagent version Wyświetl wersję agenta.
azcmagent partnerconfig Zarezerwowane do użytku wewnętrznego.

Typowe flagi

Wszystkie azcmagent polecenia obsługują następujące flagi. Aby sprawdzić, czy polecenie obsługuje inne flagi, sprawdź jego stronę referencyjną.

--config

Pobiera ścieżkę do pliku JSON lub YAML zawierającego dane wejściowe do polecenia. Plik konfiguracji powinien zawierać serię par klucz-wartość, w których klucz jest zgodny z dostępną opcją wiersza polecenia. Na przykład aby przekazać flagę --verbose , plik konfiguracji będzie wyglądać następująco:

{
    "verbose": true
}

Jeśli opcja wiersza polecenia zostanie znaleziona zarówno w wywołaniu polecenia, jak i w pliku konfiguracji, wartość określona w wierszu polecenia będzie mieć pierwszeństwo.

-h, --help

Uzyskaj pomoc dotyczącą bieżącego polecenia, w tym jego składni i opcji wiersza polecenia.

-j, --json

Wyprowadź polecenie w formacie JSON.

--log-stderr

Przekierowywanie błędów i pełnych komunikatów do strumienia błędu standardowego (stderr). Domyślnie wszystkie dane wyjściowe są wysyłane do standardowego strumienia wyjściowego (stdout).

--no-color

Wyłącz dane wyjściowe kolorów dla terminali, które nie obsługują kolorów ANSI.

-v, --verbose

Pokaż bardziej szczegółowe informacje rejestrowania podczas wykonywania polecenia. Przydatne do rozwiązywania problemów podczas uruchamiania polecenia.

Często zadawane pytania

Jak zainstalować interfejs wiersza polecenia azcmagent?

Interfejs azcmagent wiersza polecenia jest powiązany z agentem usługi Azure Connected Machine. Aby dowiedzieć się więcej o metodach instalowania i konfigurowania agenta, zobacz Opcje wdrażania agenta połączonej maszyny platformy Azure.

Gdzie jest zainstalowany interfejs wiersza polecenia?

W systemach operacyjnych Windows interfejs wiersza polecenia jest instalowany pod adresem %PROGRAMFILES%\AzureConnectedMachineAgent\azcmagent.exe. Ta ścieżka jest automatycznie dodawana do zmiennej ścieżki systemowej podczas procesu instalacji. Może być konieczne zamknięcie i ponowne otwarcie konsoli, aby odświeżyć zmienną PATH i można ją uruchomić azcmagent bez określenia pełnej ścieżki.

W systemach operacyjnych Linux interfejs wiersza polecenia jest zainstalowany pod adresem /opt/azcmagent/bin/azcmagent.

Jaka jest różnica między interfejsem azcmagent wiersza polecenia a interfejsem wiersza polecenia platformy Azure dla serwerów z obsługą usługi Azure Arc?

Interfejs azcmagent wiersza polecenia służy do konfigurowania agenta lokalnego. Jest on odpowiedzialny za łączenie agenta z platformą Azure, odłączanie go i konfigurowanie ustawień lokalnych, takich jak adresy URL serwera proxy i funkcje zabezpieczeń.

Interfejs wiersza polecenia platformy Azure i inne środowiska zarządzania są używane do interakcji z zasobem usługi Azure Arc na platformie Azure po nawiązaniu połączenia z agentem. Te narzędzia ułatwiają zarządzanie rozszerzeniami, przenoszenie zasobu do innej subskrypcji lub grupy zasobów oraz zdalne zmienianie niektórych ustawień serwera Arc.