azcmagent disconnect:

Löscht die Azure Arc-fähige Serverressource in der Cloud und setzt die Konfiguration des lokalen Agents zurück. Ausführliche Informationen zum Entfernen von Erweiterungen und zum Trennen und Deinstallieren des Agents finden Sie unter Deinstallieren des Agents.

Verwendung

azcmagent disconnect [authentication] [flags]

Beispiele

Trennen Sie einen Server mit der Standardanmeldungsmethode (interaktiver Browser oder Gerätecode).

azcmagent disconnect

Trennen Sie einen Server mithilfe eines Dienstprinzipals.

azcmagent disconnect --service-principal-id "ID" --service-principal-secret "SECRET"

Trennen Sie einen Server, wenn die entsprechende Ressource in Azure bereits gelöscht wurde.

azcmagent disconnect --force-local-only

Authentifizierungsoptionen

Es gibt 4 Möglichkeiten, Authentifizierungsanmeldeinformationen für den mit Azure verbundenen Computer-Agent bereitzustellen. Wählen Sie eine Authentifizierungsoption aus, und ersetzen Sie den [authentication] Abschnitt in der Verwendungssyntax durch die empfohlenen Flags.

Hinweis

Das Konto, das zum Trennen eines Servers verwendet wird, muss vom gleichen Mandanten wie das Abonnement stammen, in dem der Server registriert ist.

Interaktive Browseranmeldung (nur Windows)

Diese Option ist die Standardeinstellung für Windows-Betriebssysteme mit einer Desktopumgebung. Die Anmeldeseite wird in Ihrem Standardwebbrowser geöffnet. Diese Option kann erforderlich sein, wenn Ihre Organisation Richtlinien für bedingten Zugriff konfiguriert hat, die erfordern, dass Sie sich von vertrauenswürdigen Computern anmelden müssen.

Es ist keine Kennzeichnung erforderlich, um die interaktive Browseranmeldung zu verwenden.

Gerätecodeanmeldung

Diese Option generiert einen Code, mit dem Sie sich in einem Webbrowser auf einem anderen Gerät anmelden können. Dies ist die Standardoption für Windows Server Core-Editionen und alle Linux-Distributionen. Wenn Sie den Verbindungsbefehl ausführen, haben Sie 5 Minuten Zeit, um die angegebene Anmelde-URL auf einem mit dem Internet verbundenen Gerät zu öffnen und den Anmeldefluss abzuschließen.

Verwenden Sie das --use-device-code Kennzeichen, um sich mit einem Gerätecode zu authentifizieren.

Dienstprinzipal

Mit Dienstprinzipalen können Sie sich nicht interaktiv authentifizieren und werden häufig für Vorgänge im Großen und Ganzen verwendet, bei denen dasselbe Skript auf mehreren Servern ausgeführt wird. Es wird empfohlen, Dienstprinzipalinformationen über eine Konfigurationsdatei bereitzustellen (siehe --config), um zu vermeiden, dass der geheime Schlüssel in allen Konsolenprotokollen verfügbar ist.

Um sich mit einem Dienstprinzipal zu authentifizieren, stellen Sie die Anwendungs-ID und den geheimen Schlüssel des Dienstprinzipals bereit: --service-principal-id [appid] --service-principal-secret [secret]

Zugriffstoken

Zugriffstoken können auch für die nicht interaktive Authentifizierung verwendet werden, sind jedoch kurzlebig und werden in der Regel von Automatisierungslösungen verwendet, die über einen kurzen Zeitraum auf mehreren Servern ausgeführt werden. Sie können ein Zugriffstoken mit Get-AzAccessToken oder einem beliebigen anderen Microsoft Entra-Client abrufen.

Verwenden Sie das --access-token [token] Flag, um sich mit einem Zugriffstoken zu authentifizieren.

Flags

--access-token

Gibt das Microsoft Entra-Zugriffstoken an, das zum Erstellen der Azure Arc-fähigen Serverressource in Azure verwendet wird. Weitere Informationen finden Sie unter Authentifizierungsoptionen.

-f, --force-local-only

Trennt den Server, ohne die Ressource in Azure zu löschen. Wird in erster Linie verwendet, wenn die Azure-Ressource bereits gelöscht wurde und die Konfiguration des lokalen Agents sauber werden muss.

-i, --service-principal-id

Gibt die Anwendungs-ID des Dienstprinzipals an, der zum Erstellen der Azure Arc-fähigen Serverressource in Azure verwendet wird. Muss mit den --service-principal-secret Kennzeichen verwendet --tenant-id werden. Weitere Informationen finden Sie unter Authentifizierungsoptionen.

-p, --service-principal-secret

Gibt den Dienstprinzipalschlüssel an. Muss mit den --service-principal-id Kennzeichen verwendet --tenant-id werden. Um das Verfügbarmachen des geheimen Schlüssels in Konsolenprotokollen zu vermeiden, empfiehlt es sich, den Geheimschlüssel des Dienstprinzipals in einer Konfigurationsdatei zu übergeben. Weitere Informationen finden Sie unter Authentifizierungsoptionen.

--use-device-code

Generieren Sie einen Microsoft Entra-Geräteanmeldungscode, der in einen Webbrowser auf einem anderen Computer eingegeben werden kann, um den Agent bei Azure zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierungsoptionen.

--user-tenant-id

Die Mandanten-ID für das Konto, mit dem der Server mit Azure verbunden wird. Dieses Feld ist erforderlich, wenn der Mandant des Onboarding-Kontos nicht mit dem gewünschten Mandanten für die Azure Arc-fähige Serverressource identisch ist.

Allgemeine Kennzeichnungen, die für alle Befehle verfügbar sind

--config

Verwendet einen Pfad zu einer JSON- oder YAML-Datei, die Eingaben für den Befehl enthält. Die Konfigurationsdatei sollte eine Reihe von Schlüsselwertpaaren enthalten, bei denen der Schlüssel einer verfügbaren Befehlszeilenoption entspricht. Um beispielsweise das --verbose Flag zu übergeben, würde die Konfigurationsdatei wie folgt aussehen:

{
    "verbose": true
}

Wenn eine Befehlszeilenoption sowohl im Befehlsaufruf als auch in einer Konfigurationsdatei gefunden wird, hat der in der Befehlszeile angegebene Wert Vorrang.

-h, --help

Erhalten Sie Hilfe zum aktuellen Befehl, einschließlich seiner Syntax und Befehlszeilenoptionen.

-j, --json

Gibt das Befehlsergebnis im JSON-Format aus.

--log-stderr

Leiten Sie Fehler- und ausführliche Nachrichten an den Standardfehlerdatenstrom (Stderr) um. Standardmäßig wird die gesamte Ausgabe an den Standardausgabedatenstrom (Stdout) gesendet.

--no-color

Deaktivieren Sie die Farbausgabe für Terminals, die KEINE ANSI-Farben unterstützen.

-v, --verbose

Zeigen Sie detailliertere Protokollierungsinformationen an, während der Befehl ausgeführt wird. Hilfreich für die Problembehandlung beim Ausführen eines Befehls.