Freigeben über


az vm user

Verwalten von Benutzerkonten für einen virtuellen Computer.

Befehle

Name Beschreibung Typ Status
az vm user delete

Löschen eines Benutzerkontos von einem virtuellen Computer.

Core GA
az vm user reset-ssh

Zurücksetzen der SSH-Konfiguration auf einem virtuellen Computer.

Core GA
az vm user update

Aktualisieren sie ein Benutzerkonto für den virtuellen Computer. Sie können es zum Aktualisieren des Kennworts oder des SSH-Schlüsselwerts für vm-Benutzer verwenden.

Core GA

az vm user delete

Löschen eines Benutzerkontos von einem virtuellen Computer.

Löscht auch das Benutzerstartverzeichnis auf Linux-VMs.

az vm user delete --username
                  [--ids]
                  [--name]
                  [--no-wait]
                  [--resource-group]
                  [--subscription]

Beispiele

Löschen eines Benutzerkontos.

az vm user delete -u username -n MyVm -g MyResourceGroup

Löschen eines Benutzers auf allen virtuellen Computern in einer Ressourcengruppe.

az vm user delete -u username --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

Erforderliche Parameter

--username -u

Der Benutzername.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Der Name des virtuellen Computers. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az vm user reset-ssh

Zurücksetzen der SSH-Konfiguration auf einem virtuellen Computer.

Die Erweiterung startet den SSH-Dienst neu, öffnet den SSH-Port auf Ihrem virtuellen Computer, und setzt die SSH-Konfiguration auf Standardwerte zurück. Das Benutzerkonto (Name, Kennwort und SSH-Schlüssel) werden nicht geändert.

az vm user reset-ssh [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Beispiele

Zurücksetzen der SSH-Konfiguration.

az vm user reset-ssh -n MyVm -g MyResourceGroup

Setzen Sie den SSH-Server auf allen virtuellen Computern in einer Ressourcengruppe zurück.

az vm user reset-ssh --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Der Name des virtuellen Computers. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az vm user update

Aktualisieren sie ein Benutzerkonto für den virtuellen Computer. Sie können es zum Aktualisieren des Kennworts oder des SSH-Schlüsselwerts für vm-Benutzer verwenden.

Dieser Befehl verwendet VMAccessForLinux 1.5 für Linux-Betriebssystem und VMAccessAgent 2.4 für das Windows-Betriebssystem.

az vm user update --username
                  [--ids]
                  [--name]
                  [--no-wait]
                  [--password]
                  [--resource-group]
                  [--ssh-key-value]
                  [--subscription]

Beispiele

Aktualisieren eines Windows-Benutzerkontos. Wenn kein Benutzername vorhanden ist, wird ein neuer Benutzer erstellt.

az vm user update -u username -p password -n MyVm -g MyResourceGroup

Aktualisieren Sie ein Linux-Benutzerkonto. ("$(< Dateinamen)" -Syntax wird in der Eingabeaufforderung oder PowerShell nicht unterstützt.)

az vm user update -u username --ssh-key-value "$(< ~/.ssh/id_rsa.pub)" -n MyVm -g MyResourceGroup

Aktualisieren eines Benutzers auf allen virtuellen Computern in einer Ressourcengruppe. ("$(< Dateinamen)" -Syntax wird in der Eingabeaufforderung oder PowerShell nicht unterstützt.)

az vm user update -u username --ssh-key-value "$(< ~/.ssh/id_rsa.pub)" --ids $(az vm list -g MyResourceGroup --query "[].id" -o tsv)

Erforderliche Parameter

--username -u

Der Benutzername.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Der Name des virtuellen Computers. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Eigenschaft Wert
Standardwert: False
--password -p

Das Benutzerkennwort.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--ssh-key-value

SSH-Dateiwert oder Dateipfad für öffentliche Schlüssel. Dieser Befehl fügt den neuen Text des öffentlichen Schlüssels an die Datei ~/.ssh/authorized_keys für den Administratorbenutzer auf der VM an. Dadurch werden keine vorhandenen SSH-Schlüssel ersetzt oder entfernt.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False