Get-AzBatchNodeFile

Ruft die Eigenschaften von Batchknotendateien ab.

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

Beschreibung

Das Cmdlet Get-AzBatchNodeFile ruft die Eigenschaften der Azure Batch-Knotendateien eines Vorgangs- oder Computeknotens ab. Um die Ergebnisse einzuschränken, können Sie einen OData-Filter (Open Data Protocol) angeben. Wenn Sie eine Aufgabe, aber keinen Filter angeben, gibt dieses Cmdlet Eigenschaften für alle Knotendateien für diese Aufgabe zurück. Wenn Sie einen Computeknoten, aber keinen Filter angeben, gibt dieses Cmdlet Eigenschaften für alle Knotendateien für diesen Computeknoten zurück.

Beispiele

Beispiel 1: Abrufen der Eigenschaften einer Knotendatei, die einer Aufgabe zugeordnet ist

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

Dieser Befehl ruft die Eigenschaften der StdOut.txt Knotendatei ab, die der Aufgabe zugeordnet ist, die die ID Task26 im Auftrag mit dem ID-Auftrag 000001 enthält. Verwenden Sie das Cmdlet Get-AzBatchAccountKey, um der variablen $Context einen Kontext zuzuweisen.

Beispiel 2: Abrufen der Eigenschaften von Knotendateien, die einer Aufgabe zugeordnet sind, mithilfe eines Filters

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

Dieser Befehl ruft die Eigenschaften der Knotendateien ab, deren Namen mit st beginnen und der Aufgabe zugeordnet sind, die die ID Task26 unter Auftrag mit dem ID-Auftrag 00002 enthält.

Beispiel 3: Rekursiv abrufen die Eigenschaften von Knotendateien, die einer Aufgabe zugeordnet sind

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

Dieser Befehl ruft die Eigenschaften aller Dateien ab, die der Aufgabe zugeordnet sind, die die ID Task31 im Auftrag Job-00003 aufweist. Dieser Befehl gibt den rekursiven Parameter an. Daher führt das Cmdlet eine rekursive Dateisuche durch und gibt die Wd\newFile.txt-Knotendatei zurück.

Beispiel 4: Abrufen einer einzelnen Datei aus einem Computeknoten

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

Mit diesem Befehl wird die Datei "Startup\StdOut.txt" aus dem Computeknoten abgerufen, der die ID ComputeNode01 im Pool mit dem ID-Pool22 enthält.

Beispiel 5: Abrufen aller Dateien unter einem Ordner aus einem Computeknoten

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

Mit diesem Befehl werden alle Dateien unter dem Startordner aus dem Computeknoten abgerufen, der über die ID ComputeNode01 im Pool mit der ID Pool22 verfügt. Dieses Cmdlet gibt den Recursive-Parameter an.

Beispiel 6: Abrufen von Dateien aus dem Stammordner eines Computeknotens

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

Dieser Befehl ruft alle Dateien im Stammordner des Computeknotens ab, der über die ID ComputeNode01 im Pool mit dem ID Pool22 verfügt.

Parameter

-BatchContext

Gibt die BatchAccountContext-Instanz an, die dieses Cmdlet für die Interaktion mit dem Batchdienst verwendet. Wenn Sie das Cmdlet Get-AzBatchAccount verwenden, um Ihren BatchAccountContext abzurufen, wird die Microsoft Entra-Authentifizierung bei der Interaktion mit dem Batchdienst verwendet. Verwenden Sie zum Verwenden der gemeinsamen Schlüsselauthentifizierung stattdessen das Cmdlet "Get-AzBatchAccountKey", um ein BatchAccountContext-Objekt mit den aufgefüllten Zugriffstasten abzurufen. Bei Verwendung der Authentifizierung mit gemeinsam genutzten Schlüsseln wird standardmäßig der primäre Zugriffsschlüssel verwendet. Um den zu verwendenden Schlüssel zu ändern, legen Sie die BatchAccountContext.KeyInUse-Eigenschaft fest.

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputeNode

Gibt den Computeknoten als PSComputeNode-Objekt an, das die Batchknotendateien enthält. Verwenden Sie das Cmdlet Get-AzBatchComputeNode, um ein Computeknotenobjekt abzurufen.

Type:PSComputeNode
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ComputeNodeId

Gibt die ID des Computeknotens an, der die Batchknotendateien enthält.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Gibt eine OData-Filterklausel an. Dieses Cmdlet gibt Eigenschaften für Knotendateien zurück, die dem Filter entsprechen, den dieser Parameter angibt.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobId

Gibt die ID des Auftrags an, der die Zielaufgabe enthält.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxCount

Gibt die maximale Anzahl von Knotendateien an, für die dieses Cmdlet Eigenschaften zurückgibt. Wenn Sie einen Wert von Null (0) oder weniger angeben, verwendet das Cmdlet keine Obergrenze. Der Standardwert lautet „1000“.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Gibt den Pfad der Knotendatei an, für die dieses Cmdlet Eigenschaften abruft. Sie können keine Wild Karte Zeichen angeben.

Type:String
Aliases:Name
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PoolId

Gibt die ID des Pools an, der den Computeknoten enthält, aus dem Eigenschaften von Knotendateien abgerufen werden sollen.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Recursive

Gibt an, dass dieses Cmdlet eine rekursive Liste von Dateien zurückgibt. Andernfalls werden nur die Dateien im Stammordner zurückgegeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Task

Gibt die Aufgabe als PSCloudTask-Objekt an, dem die Knotendateien zugeordnet sind. Verwenden Sie zum Abrufen eines Aufgabenobjekts das Cmdlet "Get-AzBatchTask".

Type:PSCloudTask
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TaskId

Gibt die ID der Aufgabe an, für die dieses Cmdlet Eigenschaften von Knotendateien abruft.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

String

PSCloudTask

PSComputeNode

BatchAccountContext

Ausgaben

PSNodeFile