Get-AzBatchNodeFile
Obtém as propriedades dos arquivos de nó em lote.
Syntax
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.
| Type: | BatchAccountContext |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | PSComputeNode |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputeNodeId
Especifica a ID do nó de computação que contém os arquivos do nó em lote.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobId
Especifica a ID do trabalho que contém a tarefa de destino.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifica o caminho do arquivo de nó para o qual esse cmdlet recupera propriedades. Não é possível especificar caracteres curinga.
| Type: | String |
| Aliases: | Name |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PoolId
Especifica a ID do pool que contém o nó de computação do qual obter propriedades de arquivos de nó.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Recursive
Indica que esse cmdlet retorna uma lista recursiva de arquivos. Caso contrário, ele retorna apenas os arquivos na pasta raiz.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSCloudTask |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TaskId
Especifica a ID da tarefa para a qual esse cmdlet obtém propriedades de arquivos de nó.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |