Freigeben über

az batch node user

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.

 Core GA
az batch node user delete

Löscht ein Benutzerkonto aus dem angegebenen Computeknoten.

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

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

--pool-id

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-endpoint

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--account-key

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--account-name

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--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.

Eigenschaft Wert
Parameter group: User Arguments
--is-admin

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

Eigenschaft Wert
Parameter group: User Arguments
--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. Required.

Eigenschaft Wert
Parameter group: User Arguments
--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.

Eigenschaft Wert
Parameter group: User Arguments
--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).

Eigenschaft Wert
Parameter group: User 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

Output format.

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

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

Eigenschaft Wert
Standardwert: False

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

--pool-id

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

--user-name

Der Name des zu löschenden Benutzerkontos. Required.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-endpoint

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--account-key

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--account-name

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
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

Output format.

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

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

Eigenschaft Wert
Standardwert: False

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

--pool-id

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

--user-name

Der Name des zu aktualisierenden Benutzerkontos. Required.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-endpoint

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--account-key

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--account-name

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

Eigenschaft Wert
Parameter group: Batch Account Arguments
--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.

Eigenschaft Wert
Parameter group: Content Arguments
--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.

Eigenschaft Wert
Parameter group: Content Arguments
--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.

Eigenschaft Wert
Parameter group: Content 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

Output format.

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

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

Eigenschaft Wert
Standardwert: False