Get-AzBatchNodeFile
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
Saídas
Links Relacionados
Azure PowerShell