Get-AzBatchNodeFile

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

Batch ノード ファイルのプロパティを取得します。

構文

Get-AzBatchNodeFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   [[-Path] <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFile
   -JobId <String>
   -TaskId <String>
   [[-Path] <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFile
   -JobId <String>
   -TaskId <String>
   [-Filter <String>]
   [-MaxCount <Int32>]
   [-Recursive]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFile
   [[-Task] <PSCloudTask>]
   [-Filter <String>]
   [-MaxCount <Int32>]
   [-Recursive]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   [-Filter <String>]
   [-MaxCount <Int32>]
   [-Recursive]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFile
   [[-ComputeNode] <PSComputeNode>]
   [-Filter <String>]
   [-MaxCount <Int32>]
   [-Recursive]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Get-AzBatchNodeFile コマンドレットは、タスクまたはコンピューティング ノードの Azure Batch ノード ファイルのプロパティを取得します。 結果を絞り込むには、Open Data Protocol (OData) フィルターを指定します。 フィルターではなくタスクを指定した場合、このコマンドレットは、そのタスクのすべてのノード ファイルのプロパティを返します。 フィルターではなくコンピューティング ノードを指定した場合、このコマンドレットは、そのコンピューティング ノードのすべてのノード ファイルのプロパティを返します。

例

例 1: タスクに関連付けられているノード ファイルのプロパティを取得する

Get-AzBatchNodeFile -JobId "Job-000001" -TaskId "Task26" -Path "Stdout.txt" -BatchContext $Context

IsDirectory Name          Properties                                      Url

----------- ----          ----------                                      ---

False       StdOut.txt    Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...

このコマンドは、ID Job-000001 を持つジョブの ID Task26 を持つタスクに関連付けられているStdOut.txt ノード ファイルのプロパティを取得します。 Get-AzBatchAccountKey コマンドレットを使用して、$Context変数にコンテキストを割り当てます。

例 2: フィルターを使用して、タスクに関連付けられているノード ファイルのプロパティを取得する

Get-AzBatchNodeFile -JobId "Job-00002" -TaskId "Task26" -Filter "startswith(name,'St')" -BatchContext $Context

IsDirectory Name        Properties                                      Url

----------- ----        ----------                                      ---

False       StdErr.txt  Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False       StdOut.txt  Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...

このコマンドは、名前が st で始まり、ID Job-00002 を持つジョブの下に ID Task26 を持つタスクに関連付けられているノード ファイルのプロパティを取得します。

例 3: タスクに関連付けられているノード ファイルのプロパティを再帰的に取得する

Get-AzBatchTask "Job-00003" "Task31" -BatchContext $Context | Get-AzBatchNodeFile -Recursive -BatchContext $Context

IsDirectory Name             Properties                                      Url

----------- ----             ----------                                      ---

False       ProcessEnv.cmd   Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False       StdErr.txt       Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False       StdOut.txt       Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
True        wd                                                               https://cmdletexample.westus.Batch.contoso...
False       wd\newFile.txt   Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...

このコマンドは、ジョブ Job-00003 の ID Task31 を持つタスクに関連付けられているすべてのファイルのプロパティを取得します。 このコマンドは、 Recursive パラメーターを指定します。 したがって、コマンドレットは再帰的なファイル検索を実行し、wd\newFile.txt ノード ファイルを返します。

例 4: コンピューティング ノードから 1 つのファイルを取得する

Get-AzBatchNodeFile -PoolId "Pool22" -ComputeNodeId "ComputeNode01" -Path "Startup\StdOut.txt" -BatchContext $Context

IsDirectory Name                    Properties                                      Url
----------- ----                    ----------                                      ---
False       startup\stdout.txt      Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...

このコマンドは、ID Pool22 を持つプール内の ID ComputeNode01 を持つコンピューティング ノードから Startup\StdOut.txt という名前のファイルを取得します。

例 5: コンピューティング ノードからフォルダーの下にあるすべてのファイルを取得する

Get-AzBatchNodeFile -PoolId "Pool22" -ComputeNodeId "ComputeNode01" -Filter "startswith(name,'startup')" -Recursive -BatchContext $Context

IsDirectory Name                      Properties                                      Url
----------- ----                      ----------                                      ---
True        startup                                                                   https://cmdletexample.westus.Batch.contoso...
False       startup\ProcessEnv.cmd    Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False       startup\stderr.txt        Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False       startup\stdout.txt        Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
True        startup\wd                                                                https://cmdletexample.westus.Batch.contoso...

このコマンドは、ID Pool22 を持つプール内の ID ComputeNode01 を持つコンピューティング ノードから、スタートアップ フォルダーの下にあるすべてのファイルを取得します。 このコマンドレットは、 Recursive パラメーターを指定します。

例 6: コンピューティング ノードのルート フォルダーからファイルを取得する

Get-AzBatchComputeNode "Pool22" -Id "ComputeNode01" -BatchContext $Context | Get-AzBatchNodeFile -BatchContext $Context

IsDirectory Name           Properties       Url
----------- ----           ----------       ---
True        shared                          https://cmdletexample.westus.Batch.contoso...
True        startup                         https://cmdletexample.westus.Batch.contoso...
True        workitems                       https://cmdletexample.westus.Batch.contoso...

このコマンドは、ID Pool22 を持つプール内の ID ComputeNode01 を持つコンピューティング ノードのルート フォルダーにあるすべてのファイルを取得します。

パラメーター

-BatchContext

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

型:BatchAccountContext
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ComputeNode

Batch ノード ファイルを含むコンピューティング ノードを PSComputeNode オブジェクトとして指定します。 コンピューティング ノード オブジェクトを取得するには、Get-AzBatchComputeNode コマンドレットを使用します。

型:PSComputeNode
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ComputeNodeId

Batch ノード ファイルを含むコンピューティング ノードの ID を指定します。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Filter

OData フィルター句を指定します。 このコマンドレットは、このパラメーターが指定するフィルターに一致するノード ファイルのプロパティを返します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobId

ターゲット タスクを含むジョブの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MaxCount

このコマンドレットがプロパティを返すノード ファイルの最大数を指定します。 0 以下の値を指定した場合、このコマンドレットでは上限は使用されません。 既定値は 1000 です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Path

このコマンドレットがプロパティを取得するノード ファイルのパスを指定します。 ワイルドカード文字を指定することはできません。

型:String
Aliases:Name
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PoolId

ノード ファイルのプロパティを取得するコンピューティング ノードを含むプールの ID を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Recursive

このコマンドレットは、ファイルの再帰的な一覧を返します。 それ以外の場合は、ルート フォルダー内のファイルのみが返されます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Task

ノード ファイルが関連付けられているタスクを PSCloudTask オブジェクトとして指定します。 タスク オブジェクトを取得するには、Get-AzBatchTask コマンドレットを使用します。

型:PSCloudTask
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-TaskId

このコマンドレットがノード ファイルのプロパティを取得するタスクの ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

String

PSCloudTask

PSComputeNode

BatchAccountContext

出力

PSNodeFile