你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

此命令获取与 ID 为 Job-000001 的作业中 ID 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 开头的节点文件的属性，并与 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...

此命令获取与作业作业 -00003 中 ID 任务 31 的任务关联的所有文件的属性。 此命令指定 递归 参数。 因此，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 的池中 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 的计算节点获取启动文件夹下的所有文件。 此 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 的池中 ID ComputeNode01 的计算节点根文件夹中的所有文件。

参数

-BatchContext

指定 此 cmdlet 用于与 Batch 服务交互的 BatchAccountContext 实例。 如果使用 Get-AzBatchAccount cmdlet 获取 BatchAccountContext，Microsoft 则在与 Batch 服务交互时将使用 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 节点文件的计算节点的 ID。

类型:	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

指定包含目标任务的作业的 ID。

类型:	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

指定包含从中获取节点文件属性的计算节点的池的 ID。

类型:	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 获取节点文件属性的任务的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

String

PSCloudTask

PSComputeNode

BatchAccountContext

输出

PSNodeFile

相关链接

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