Freigeben über

az batch node user

  • Referenz

Verwalten Sie die Benutzerkonten eines Batch-Computeknotens.

Befehle

Name Beschreibung Typ Status
az batch node user create

Fügen Sie einem Batch-Computeknoten ein Benutzerkonto hinzu.

 Kern GA
az batch node user delete

Löscht ein Benutzerkonto aus dem angegebenen Computeknoten.

 Kern GA
az batch node user reset

Aktualisieren sie die Eigenschaften eines Benutzerkontos auf einem Batch-Computeknoten. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt.

 Kern GA

az batch node user create

Bearbeiten

Fügen Sie einem Batch-Computeknoten ein Benutzerkonto hinzu.

az batch node user create --node-id
                          --pool-id
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--expiry-time]
                          [--is-admin]
                          [--json-file]
                          [--name]
                          [--password]
                          [--ssh-public-key]

Beispiele

Erstellen Sie einen regulären Benutzer (nicht als Administrator) mit einem öffentlichen SSH-Schlüssel.

az batch node user create --pool-id pool1 --node-id node1 --name example_user --ssh-public-key example_public_key

Erforderliche Parameter

--node-id

Die ID des Computers, auf dem Sie ein Benutzerkonto erstellen möchten. Erforderlich.

--pool-id

Die ID des Pools, der den Computeknoten enthält. Erforderlich.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--expiry-time

Der Zeitpunkt, zu dem das Konto abläuft. Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 1 Tag ab der aktuellen Uhrzeit. Für Linux-Computeknoten hat die Ablaufzeit bis zu einem Tag eine Genauigkeit. Das erwartete Format ist ein ISO-8601-Zeitstempel.

--is-admin

Gibt an, ob das Konto ein Administrator auf dem Computeknoten sein soll. Der Standardwert ist "false". True, wenn die Kennzeichnung vorhanden ist.

--json-file

Eine Datei, die die Benutzerspezifikation in JSON enthält (formatiert mit dem jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle "Benutzerargumente" ignoriert.

--name

Der Benutzername des Kontos. Erforderlich.

--password

Das Kennwort des Kontos. Das Kennwort ist für Windows-Computeknoten erforderlich (die mit "virtualMachineConfiguration" mithilfe eines Windows-Imageverweises erstellt wurden). Für Linux Compute Nodes kann das Kennwort optional zusammen mit der sshPublicKey-Eigenschaft angegeben werden.

--ssh-public-key

Der öffentliche SSH-Schlüssel, der für die Remoteanmeldung beim Computeknoten verwendet werden kann. Der öffentliche Schlüssel sollte mit der OpenSSH-Codierung kompatibel sein und base64-codiert sein. Diese Eigenschaft kann nur für Linux-Computeknoten angegeben werden. Wenn dies für einen Windows-Computeknoten angegeben ist, lehnt der Batchdienst die Anforderung ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

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

--verbose

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

az batch node user delete

Bearbeiten

Löscht ein Benutzerkonto aus dem angegebenen Computeknoten.

Sie können ein Benutzerkonto nur dann in einem Computeknoten löschen, wenn es sich im Leerlauf- oder Ausführungszustand befindet.

az batch node user delete --node-id
                          --pool-id
                          --user-name
                          [--account-endpoint]
                          [--account-key]
                          [--account-name]
                          [--yes]

Erforderliche Parameter

--node-id

Die ID des Computers, auf dem Sie ein Benutzerkonto löschen möchten. Erforderlich.

--pool-id

Die ID des Pools, der den Computeknoten enthält. Erforderlich.

--user-name

Der Name des zu löschenden Benutzerkontos. Erforderlich.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

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

--verbose

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

az batch node user reset

Bearbeiten

Aktualisieren sie die Eigenschaften eines Benutzerkontos auf einem Batch-Computeknoten. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt.

az batch node user reset --node-id
                         --pool-id
                         --user-name
                         [--account-endpoint]
                         [--account-key]
                         [--account-name]
                         [--expiry-time]
                         [--json-file]
                         [--password]
                         [--ssh-public-key]

Beispiele

Legen Sie einen neuen öffentlichen SSH-Schlüssel für einen vorhandenen Benutzer fest, und setzen Sie alle anderen Eigenschaften auf ihre Standardwerte zurück.

az batch node user reset --pool-id pool1 --node-id node1 --user-name example_user --ssh-public-key new_public_key

Erforderliche Parameter

--node-id

Die ID des Computers, auf dem Sie ein Benutzerkonto aktualisieren möchten. Erforderlich.

--pool-id

Die ID des Pools, der den Computeknoten enthält. Erforderlich.

--user-name

Der Name des zu aktualisierenden Benutzerkontos. Erforderlich.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--expiry-time

Der Zeitpunkt, zu dem das Konto abläuft. Wenn dieser Wert nicht angegeben wird, beträgt der Standardwert 1 Tag ab der aktuellen Uhrzeit. Für Linux-Computeknoten hat die Ablaufzeit bis zu einem Tag eine Genauigkeit. Das erwartete Format ist ein ISO-8601-Zeitstempel.

--json-file

Eine Datei, die die Inhaltsspezifikation in JSON enthält (formatiert mit dem jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle Inhaltsargumente ignoriert.

--password

Das Kennwort des Kontos. Das Kennwort ist für Windows-Computeknoten erforderlich (die mit "virtualMachineConfiguration" mithilfe eines Windows-Imageverweises erstellt wurden). Für Linux Compute Nodes kann das Kennwort optional zusammen mit der sshPublicKey-Eigenschaft angegeben werden. Wenn nicht angegeben, wird ein vorhandenes Kennwort entfernt.

--ssh-public-key

Der öffentliche SSH-Schlüssel, der für die Remoteanmeldung beim Computeknoten verwendet werden kann. Der öffentliche Schlüssel sollte mit der OpenSSH-Codierung kompatibel sein und base64-codiert sein. Diese Eigenschaft kann nur für Linux-Computeknoten angegeben werden. Wenn dies für einen Windows-Computeknoten angegeben ist, lehnt der Batchdienst die Anforderung ab; wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). Wenn nicht angegeben, wird ein vorhandener öffentlicher SSH-Schlüssel entfernt.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

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

--verbose

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