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

Description

Get-AzBatchNodeFile Cmdlet 會取得工作或計算節點的 Azure Batch 節點檔案屬性。 若要縮小結果範圍，您可以指定開放式數據通訊協定 （OData） 篩選條件。 如果您指定工作，但不是篩選，此 Cmdlet 會傳回該工作所有節點檔案的屬性。 如果您指定計算節點，但不是篩選條件，此 Cmdlet 會傳回該計算節點所有節點檔案的屬性。

範例

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

此命令會取得與標識碼為 Job-000001 之作業中標識碼 Task26 之工作相關聯的StdOut.txt節點檔案屬性。 使用 Get-AzBatchAccountKey Cmdlet 將內容指派給$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 且與標識符為 Task26 的工作相關聯的節點檔案屬性，該工作在標識符為 Job-00002 的工作下。

範例 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 中標識碼為 Task31 之工作相關聯的所有檔案屬性。 此命令會 指定遞歸 參數。 因此，Cmdlet 會執行遞歸檔案搜尋，並傳回 wd\newFile.txt 節點檔案。

範例 4：從計算節點取得單一檔案

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之集區中標識碼 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之集區中標識碼 ComputeNode01 的計算節點，取得啟動資料夾下的所有檔案。 此 Cmdlet 會 指定遞歸 參數。

範例 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之集區中標識碼 ComputeNode01 之計算節點根資料夾的所有檔案。

參數

-BatchContext

指定 此 Cmdlet 用來與 Batch 服務互動的 BatchAccountContext 實例。 如果您使用 Get-AzBatchAccount Cmdlet 來取得 BatchAccountContext，則與 Batch 服務互動時，將會使用Microsoft Entra 驗證。 若要改用共用密鑰驗證，請使用 Get-AzBatchAccountKey Cmdlet 來取得已填入其存取密鑰的 BatchAccountContext 物件。 使用共用金鑰驗證時，預設會使用主要存取金鑰。 若要變更要使用的密鑰，請設定 BatchAccountContext.KeyInUse 屬性。

類型:	BatchAccountContext
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ComputeNode

將計算節點指定為 包含 Batch 節點檔案的 PSComputeNode 物件。 若要取得計算節點物件，請使用 Get-AzBatchComputeNode Cmdlet。

類型:	PSComputeNode
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ComputeNodeId

指定包含 Batch 節點檔案的計算節點識別碼。

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Filter

指定 OData 篩選子句。 此 Cmdlet 會傳回符合此參數所指定篩選條件之節點檔案的屬性。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-JobId

指定包含目標工作的作業識別碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-MaxCount

指定這個 Cmdlet 傳回屬性的節點檔案數目上限。 如果您指定零 （0） 或更少值，Cmdlet 就不會使用上限。 預設值為 1000。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

指定這個 Cmdlet 擷取屬性之節點檔案的路徑。 您無法指定通配符。

類型:	String
別名:	Name
Position:	2
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PoolId

指定要從中取得節點檔案屬性之計算節點的集區標識碼。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Recursive

指出這個 Cmdlet 會傳回遞歸的檔案清單。 否則，它只會傳回根資料夾中的檔案。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Task

將工作指定為 PSCloudTask 物件，其中與節點檔案相關聯。 若要取得工作物件，請使用 Get-AzBatchTask Cmdlet。

類型:	PSCloudTask
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-TaskId

指定此 Cmdlet 取得節點檔案屬性之工作的識別碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

輸入

String

PSCloudTask

PSComputeNode

BatchAccountContext

輸出

PSNodeFile

相關連結

• Get-AzBatchAccountKey
• Get-AzBatchComputeNode
• Get-AzBatchNodeFileContent
• Get-AzBatchTask
• Azure Batch Cmdlet