Freigeben über

Get-AzBatchNodeFile

  • Referenz
Modul:
Az.Batch

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 in dem Auftrag enthält, der den ID-Auftrag 000001 aufweist. 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 Recursive-Parameter an. Daher führt das Cmdlet eine rekursive Dateisuche aus 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 mit dem Namen "Startup\StdOut.txt" aus dem Computeknoten abgerufen, der über die ID ComputeNode01 im Pool mit dem ID-Pool22 verfügt.

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

Typ:BatchAccountContext
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputeNode

Gibt den Computeknoten als PSComputeNode- -Objekt an, der die Batchknotendateien enthält. Verwenden Sie zum Abrufen eines Computeknotenobjekts das cmdlet Get-AzBatchComputeNode.

Typ:PSComputeNode
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputeNodeId

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

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Filter

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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 ist 1000.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

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

Typ:String
Aliase:Name
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PoolId

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Recursive

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Task

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

Typ:PSCloudTask
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TaskId

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben