New-AzBatchComputeNodeUser

  • リファレンス
モジュール:
Az.Batch

Batch コンピューティング ノードにユーザー アカウントを作成します。

構文

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

説明

New-AzBatchComputeNodeUser コマンドレットは、Azure Batch コンピューティング ノードにユーザー アカウントを作成します。

例

例 1: 管理者資格情報を持つユーザー アカウントを作成する

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

このコマンドは、ID ComputeNode01 を持つコンピューティング ノードにユーザー アカウントを作成します。 ノードは、ID MyPool01 を持つプール内にあります。 ユーザー名は TestUser、パスワードはパスワード、アカウントの有効期限は 7 日で、アカウントは管理者資格情報を持ちます。

例 2: パイプラインを使用してコンピューティング ノードにユーザー アカウントを作成する

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

このコマンドは、Get-AzBatchComputeNode コマンドレットを使用して ComputeNode01 という名前のコンピューティング ノードを取得します。 そのノードは、ID MyPool01 を持つプール内にあります。 このコマンドは、パイプライン演算子を使用して、そのコンピューティング ノードを現在のコマンドレットに渡します。 このコマンドは、ユーザー名 TestUser とパスワード パスワードを持つユーザー アカウントを作成します。

パラメーター

-BatchContext

このコマンドレットが Batch サービスとの対話に使用する BatchAccountContext インスタンスを指定します。 Get-AzBatchAccount コマンドレットを使用して BatchAccountContext を取得する場合、Batch サービスと対話するときに Microsoft Entra 認証が使用されます。 代わりに共有キー認証を使用するには、Get-AzBatchAccountKey コマンドレットを使用して、アクセス キーが設定された BatchAccountContext オブジェクトを取得します。 共有キー認証を使用する場合、プライマリ アクセス キーは既定で使用されます。 使用するキーを変更するには、BatchAccountContext.KeyInUse プロパティを設定します。

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputeNode

計算ノードを PSComputeNode オブジェクトとして指定し、このコマンドレットでユーザー アカウントを作成します。

Type:PSComputeNode
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ComputeNodeId

このコマンドレットでユーザー アカウントを作成するコンピューティング ノードの ID を指定します。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpiryTime

新しいユーザー アカウントの有効期限を指定します。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAdmin

コマンドレットが管理者資格情報を持つユーザー アカウントを作成することを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

新しいローカル Windows アカウントの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Password

ユーザー アカウントのパスワードを指定します。

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PoolId

ユーザー アカウントを作成するコンピューティング ノードを含むプールの ID を指定します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

入力

PSComputeNode

BatchAccountContext

出力

Void