Share via


New-AzureBatchComputeNodeUser

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

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

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

説明

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

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

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

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

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

PS C:\>Get-AzureBatchComputeNode "MyPool01" -ComputeNodeId "ComputeNode01" -BatchContext $Context | New-AzureBatchComputeNodeUser -Name "TestUser" -Password "Password" -BatchContext $Context

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

パラメーター

-BatchContext

このコマンドレットが Batch サービスとの対話に使用する BatchAccountContext インスタンスを指定します。 Get-AzureRmBatchAccount コマンドレットを使用して BatchAccountContext を取得する場合、Batch サービスを操作するときに Microsoft Entra 認証が使用されます。 代わりに共有キー認証を使用するには、Get-AzureRmBatchAccountKeys コマンドレットを使用して、アクセス キーが設定された 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: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

パラメーター: ComputeNode (ByValue)

BatchAccountContext

パラメーター: BatchContext (ByValue)

出力

Void