Azcmagent CLI-Referenz

Das Befehlszeilentool des Azure Connected Machine-Agents hilft Ihnen, azcmagentdie Verbindung eines Servers mit Azure Arc zu konfigurieren, zu verwalten und zu beheben. Die azcmagent CLI wird mit dem Azure Connected Machine-Agent installiert und steuert Aktionen speziell für den Server, auf dem sie ausgeführt wird. Sobald der Server mit Azure Arc verbunden ist, können Sie das Azure CLI - oder Azure PowerShell-Modul verwenden, um Erweiterungen zu aktivieren, Tags zu verwalten und andere Vorgänge auf der Serverressource auszuführen.

Sofern nicht anders angegeben, stellen die Befehlssyntax und flags verfügbare Optionen in der neuesten Version des Azure Connected Machine-Agents dar. Weitere Informationen finden Sie unter What's new with the Azure Connected Machine agent.

Führen Sie die folgenden Referenzseiten aus, um Details zu den einzelnen Befehlen zu erhalten, azcmagent COMMANDNAME --help die in der azcmagent CLI verfügbar sind:

Befehle

Allgemeine Kennzeichnungen

Alle azcmagent Befehle unterstützen die folgenden Flags. Um festzustellen, ob ein Befehl andere Flags unterstützt, überprüfen Sie dessen Referenzseite.

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

Häufig gestellte Fragen

Wie kann ich die Azcmagent CLI installieren?

Die azcmagent CLI wird mit dem Azure Connected Machine-Agent gebündelt. Informationen zu Methoden zum Installieren und Konfigurieren des Agents finden Sie unter Bereitstellungsoptionen für den Azure Connected Machine-Agent.

Wo ist die CLI installiert?

Unter Windows-Betriebssystemen wird die CLI unter %PROGRAMFILES%\AzureConnectedMachineAgent\azcmagent.exe. Dieser Pfad wird während des Installationsvorgangs automatisch der SystemPFAD-Variablen hinzugefügt. Möglicherweise müssen Sie die Konsole schließen und erneut öffnen, um die PATH-Variable zu aktualisieren und ohne angabe des vollständigen Pfads auszuführen azcmagent .

Auf Linux-Betriebssystemen wird die CLI unter /opt/azcmagent/bin/azcmagent.

Was ist der Unterschied zwischen der azcmagent CLI und der Azure CLI für Azure Arc-fähige Server?

Die azcmagent CLI wird verwendet, um den lokalen Agent zu konfigurieren. Er ist dafür verantwortlich, den Agent mit Azure zu verbinden, ihn zu trennen und lokale Einstellungen wie Proxy-URLs und Sicherheitsfeatures zu konfigurieren.

Die Azure CLI und andere Verwaltungsoberflächen werden verwendet, um mit der Azure Arc-Ressource in Azure zu interagieren, sobald der Agent verbunden ist. Mit diesen Tools können Sie Erweiterungen verwalten, die Ressource in ein anderes Abonnement oder eine andere Ressourcengruppe verschieben und bestimmte Einstellungen des Arc-Servers remote ändern.