Compartilhar via

Get-AzBatchNodeFile

  • Referência
Módulo:
Az.Batch

Obtém as propriedades dos arquivos de nó do 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 um nó de computação ou tarefa. Para restringir seus 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ó para essa tarefa. Se você especificar um nó de computação, mas não um filtro, esse cmdlet retornará propriedades para todos os arquivos de nó para esse 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...

Esse comando obtém as propriedades do arquivo de nó StdOut.txt associado à tarefa que tem a ID Task26 no trabalho que tem o Trabalho de ID-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...

Esse comando obtém as propriedades dos arquivos de nó cujos nomes começam com st e são associados à tarefa que tem a ID Task26 no trabalho que tem o Trabalho de ID-00002.

Exemplo 3: obter recursivamente as propriedades de 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...

Esse comando obtém as propriedades de todos os arquivos associados à tarefa que tem a ID Task31 no trabalho Job-00003. Esse comando especifica o parâmetro Recursivo . 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...

Esse comando obtém o arquivo chamado Inicialização\StdOut.txt do nó de computação que tem a ID ComputeNode01 no pool que tem o Pool de IDs22.

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

Esse 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 o Pool de IDs22. Esse cmdlet especifica o parâmetro recursivo .

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

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

Parâmetros

-BatchContext

Especifica a instância BatchAccountContext que esse cmdlet usa para interagir com o serviço do Lote. Se você usar o cmdlet Get-AzBatchAccount para obter o BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço do Lote. 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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ComputeNode

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

Tipo:PSComputeNode
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ComputeNodeId

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

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Filter

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MaxCount

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica o caminho do arquivo de nó para o qual esse cmdlet recupera propriedades. Você não pode especificar caracteres curinga.

Tipo:String
Aliases:Name
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Recursive

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Task

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

Tipo:PSCloudTask
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TaskId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

PSCloudTask

PSComputeNode

BatchAccountContext

Saídas

PSNodeFile