Partilhar via

Get-AzBatchNodeFile

  • Referência
Módulo:
Az.Batch

Obtém as propriedades dos arquivos de nó em lote.

Sintaxe

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

O cmdlet Get-AzBatchNodeFile obtém as propriedades dos arquivos de nó do Lote do Azure de uma tarefa ou nó de computação. Para restringir os resultados, você pode especificar um filtro OData (Open Data Protocol). Se você especificar uma tarefa, mas não um filtro, esse cmdlet retornará propriedades para todos os arquivos de nó dessa tarefa. Se você especificar um nó de computação, mas não um filtro, esse cmdlet retornará propriedades para todos os arquivos de nó desse nó de computação.

Exemplos

Exemplo 1: Obter as propriedades de um arquivo de nó associado a uma tarefa

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

Este comando obtém as propriedades do arquivo de nó StdOut.txt associado à tarefa que tem a ID Task26 no trabalho que tem a ID Job-000001. Use o cmdlet Get-AzBatchAccountKey para atribuir um contexto à variável $Context.

Exemplo 2: Obter as propriedades dos arquivos de nó associados a uma tarefa usando um filtro

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

Este comando obtém as propriedades dos arquivos de nó cujos nomes começam com st e estão associados à tarefa que tem a ID Task26 em job que tem a ID Job-00002.

Exemplo 3: Obter recursivamente as propriedades dos arquivos de nó associados a uma tarefa

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

Este comando obtém as propriedades de todos os arquivos associados à tarefa que tem a ID Task31 no trabalho Job-00003. Este comando especifica o parâmetro Recursive . Portanto, o cmdlet executa uma pesquisa de arquivo recursiva e retorna o arquivo de nó wd\newFile.txt.

Exemplo 4: Obter um único arquivo de um nó de computação

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

Este comando obtém o arquivo chamado Startup\StdOut.txt do nó de computação que tem a ID ComputeNode01 no pool que tem a ID Pool22.

Exemplo 5: Obter todos os arquivos em uma pasta de um nó de computação

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

Este comando obtém todos os arquivos na pasta de inicialização do nó de computação que tem a ID ComputeNode01 no pool que tem a ID Pool22. Este cmdlet especifica o parâmetro Recursive .

Exemplo 6: Obter arquivos da pasta raiz de um nó de computação

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

Este comando obtém todos os arquivos na pasta raiz do nó de computação que tem a ID ComputeNode01 no pool que tem a ID Pool22.

Parâmetros

-BatchContext

Especifica a instância BatchAccountContext que esse cmdlet usa para interagir com o serviço Batch. Se você usar o cmdlet Get-AzBatchAccount para obter seu BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço Batch. Para usar a autenticação de chave compartilhada, use o cmdlet Get-AzBatchAccountKey para obter um objeto BatchAccountContext com suas chaves de acesso preenchidas. Ao usar a autenticação de chave compartilhada, a chave de acesso primária é usada por padrão. Para alterar a chave a ser usada, defina a propriedade BatchAccountContext.KeyInUse.

Tipo:BatchAccountContext
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ComputeNode

Especifica o nó de computação, como um objeto PSComputeNode, que contém os arquivos do nó Batch. Para obter um objeto de nó de computação, use o cmdlet Get-AzBatchComputeNode.

Tipo:PSComputeNode
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ComputeNodeId

Especifica a ID do nó de computação que contém os arquivos do nó em lote.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Filter

Especifica uma cláusula de filtro OData. Este cmdlet retorna propriedades para arquivos de nó que correspondem ao filtro especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobId

Especifica a ID do trabalho que contém a tarefa de destino.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MaxCount

Especifica o número máximo de arquivos de nó para os quais esse cmdlet retorna propriedades. Se você especificar um valor de zero (0) ou menos, o cmdlet não usará um limite superior. O valor predefinido é 1000.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Especifica o caminho do arquivo de nó para o qual esse cmdlet recupera propriedades. Não é possível especificar caracteres curinga.

Tipo:String
Aliases:Name
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PoolId

Especifica a ID do pool que contém o nó de computação do qual obter propriedades de arquivos de nó.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Recursive

Indica que esse cmdlet retorna uma lista recursiva de arquivos. Caso contrário, ele retorna apenas os arquivos na pasta raiz.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Task

Especifica a tarefa, como um objeto PSCloudTask , à qual os arquivos de nó estão associados. Para obter um objeto de tarefa, use o cmdlet Get-AzBatchTask.

Tipo:PSCloudTask
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TaskId

Especifica a ID da tarefa para a qual esse cmdlet obtém propriedades de arquivos de nó.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

String

PSCloudTask

PSComputeNode

BatchAccountContext

Saídas

PSNodeFile