Freigeben über

New-AzBatchComputeNodeUser

  • Referenz
Modul:
Az.Batch

Erstellt ein Benutzerkonto auf einem Batch-Computeknoten.

Syntax

New-AzBatchComputeNodeUser
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   -Name <String>
   -Password <SecureString>
   [-ExpiryTime <DateTime>]
   [-IsAdmin]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzBatchComputeNodeUser
   [[-ComputeNode] <PSComputeNode>]
   -Name <String>
   -Password <SecureString>
   [-ExpiryTime <DateTime>]
   [-IsAdmin]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzBatchComputeNodeUser erstellt ein Benutzerkonto auf einem Azure Batch-Computeknoten.

Beispiele

Beispiel 1: Erstellen eines Benutzerkontos mit Administratoranmeldeinformationen

New-AzBatchComputeNodeUser -PoolId "MyPool01" -ComputeNodeId "ComputeNode01" -Name "TestUser" -Password "Password" -ExpiryTime ([DateTime]::Now.AddDays(7)) -IsAdmin -BatchContext $Context

Dieser Befehl erstellt ein Benutzerkonto auf dem Computeknoten mit der ID ComputeNode01. Der Knoten befindet sich im Pool mit der ID "MyPool01". Der Benutzername lautet "TestUser", das Kennwort ist "Password", das Konto läuft in sieben Tagen ab, und das Konto verfügt über Administratoranmeldeinformationen.

Beispiel 2: Erstellen eines Benutzerkontos auf einem Computeknoten mithilfe der Pipeline

Get-AzBatchComputeNode "MyPool01" -Id "ComputeNode01" -BatchContext $Context | New-AzBatchComputeNodeUser -Name "TestUser" -Password "Password" -BatchContext $Context

Mit diesem Befehl wird der Computeknoten "ComputeNode01" mithilfe des Cmdlets "Get-AzBatchComputeNode " abgerufen. Dieser Knoten befindet sich im Pool mit der ID "MyPool01". Der Befehl übergibt diesen Computeknoten mithilfe des Pipelineoperators an das aktuelle Cmdlet. Der Befehl erstellt ein Benutzerkonto mit dem Benutzernamen TestUser und dem Kennwortkennwort.

Parameter

-BatchContext

Gibt die BatchAccountContext-Instanz an, die dieses Cmdlet für die Interaktion mit dem Batchdienst verwendet. Wenn Sie das Cmdlet Get-AzBatchAccount verwenden, um Ihren BatchAccountContext abzurufen, wird die Microsoft Entra-Authentifizierung bei der Interaktion mit dem Batchdienst verwendet. Verwenden Sie zum Verwenden der gemeinsamen Schlüsselauthentifizierung stattdessen das Cmdlet "Get-AzBatchAccountKey", um ein BatchAccountContext-Objekt mit den aufgefüllten Zugriffstasten abzurufen. Bei Verwendung der Authentifizierung mit gemeinsam genutzten Schlüsseln wird standardmäßig der primäre Zugriffsschlüssel verwendet. Um den zu verwendenden Schlüssel zu ändern, legen Sie die BatchAccountContext.KeyInUse-Eigenschaft fest.

Typ:BatchAccountContext
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputeNode

Gibt den Computeknoten als PSComputeNode-Objekt an, für das dieses Cmdlet ein Benutzerkonto erstellt.

Typ:PSComputeNode
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputeNodeId

Gibt die ID des Computeknotens an, auf dem dieses Cmdlet ein Benutzerkonto erstellt.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpiryTime

Gibt die Ablaufzeit für das neue Benutzerkonto an.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsAdmin

Gibt an, dass das Cmdlet ein Benutzerkonto erstellt, das über Administratoranmeldeinformationen verfügt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des neuen lokalen Windows-Kontos an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Password

Gibt das Kennwort für das Benutzerkonto an.

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PoolId

Gibt die ID des Pools an, der den Computeknoten enthält, auf dem das Benutzerkonto erstellt werden soll.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSComputeNode

BatchAccountContext

Ausgaben

Void