Freigeben über

Get-AzBatchNodeFileContent

  • Referenz
Modul:
Az.Batch

Ruft eine Batchknotendatei ab.

Syntax

Get-AzBatchNodeFileContent
   -JobId <String>
   -TaskId <String>
   [-Path] <String>
   -DestinationPath <String>
   [-ByteRangeStart <Int64>]
   [-ByteRangeEnd <Int64>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFileContent
   -JobId <String>
   -TaskId <String>
   [-Path] <String>
   -DestinationStream <Stream>
   [-ByteRangeStart <Int64>]
   [-ByteRangeEnd <Int64>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFileContent
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   [-Path] <String>
   -DestinationPath <String>
   [-ByteRangeStart <Int64>]
   [-ByteRangeEnd <Int64>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFileContent
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   [-Path] <String>
   -DestinationStream <Stream>
   [-ByteRangeStart <Int64>]
   [-ByteRangeEnd <Int64>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFileContent
   [[-InputObject] <PSNodeFile>]
   -DestinationPath <String>
   [-ByteRangeStart <Int64>]
   [-ByteRangeEnd <Int64>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchNodeFileContent
   [[-InputObject] <PSNodeFile>]
   -DestinationStream <Stream>
   [-ByteRangeStart <Int64>]
   [-ByteRangeEnd <Int64>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-AzBatchNodeFileContent ruft eine Azure Batch-Knotendatei ab und speichert sie als Datei oder in einem Stream.

Beispiele

Beispiel 1: Abrufen einer Batchknotendatei, die einer Aufgabe zugeordnet ist, und Speichern der Datei

Get-AzBatchNodeFileContent -JobId "Job01" -TaskId "Task01" -Path "StdOut.txt" -DestinationPath "E:\PowerShell\StdOut.txt" -BatchContext $Context

Dieser Befehl ruft die Knotendatei ab, die StdOut.txtheißt, und speichert sie im E:\PowerShell\StdOut.txt Dateipfad auf dem lokalen Computer. Die StdOut.txt Knotendatei ist einer Aufgabe zugeordnet, die die ID Task01 für den Auftrag mit dem ID-Auftrag01 enthält. Verwenden Sie das Cmdlet Get-AzBatchAccountKey, um der variablen $Context einen Kontext zuzuweisen.

Beispiel 2: Abrufen einer Batchknotendatei und Speichern in einem angegebenen Dateipfad mithilfe der Pipeline

Get-AzBatchNodeFile -JobId "Job02" -TaskId "Task02" -Path "StdErr.txt" -BatchContext $Context | Get-AzBatchNodeFileContent -DestinationPath "E:\PowerShell\StdOut.txt" -BatchContext $Context

Mit diesem Befehl wird die Knotendatei mit dem Namen StdErr.txt mithilfe des cmdlets Get-AzBatchNodeFile. Der Befehl übergibt diese Datei mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet speichert diese Datei im E:\PowerShell\StdOut.txt Dateipfad auf dem lokalen Computer. Die StdOut.txt Knotendatei ist der Aufgabe zugeordnet, die die ID Task02 für den Auftrag enthält, der den ID-Auftrag 02 aufweist.

Beispiel 3: Abrufen einer Batchknotendatei, die einer Aufgabe zugeordnet ist, und leiten Sie sie an einen Stream weiter.

$Stream = New-Object -TypeName "System.IO.MemoryStream"
Get-AzBatchNodeFileContent -JobId "Job03" -TaskId "Task11" -Path "StdOut.txt" -DestinationStream $Stream -BatchContext $Context

Der erste Befehl erstellt einen Datenstrom mithilfe des cmdlets New-Object und speichert ihn dann in der variablen $Stream. Der zweite Befehl ruft die Knotendatei ab, die StdOut.txt aus der Aufgabe mit der ID Task11 für den Auftrag mit dem ID-Auftrag03 benannt wird. Der Befehl leitet Dateiinhalte in $Stream an den Datenstrom weiter.

Beispiel 4: Abrufen einer Knotendatei aus einem Computeknoten und Speichern

Get-AzBatchNodeFileContent -PoolId "Pool01" -ComputeNodeId "ComputeNode01" -Path "Startup\StdOut.txt" -DestinationPath "E:\PowerShell\StdOut.txt" -BatchContext $Context

Dieser Befehl ruft die Knotendatei startup\StdOut.txt aus dem Computeknoten ab, der die ID ComputeNode01 im Pool mit dem ID-Pool01 enthält. Der Befehl speichert die Datei im E:\PowerShell\StdOut.txt Dateipfad auf dem lokalen Computer.

Beispiel 5: Abrufen einer Knotendatei aus einem Computeknoten und Speichern mithilfe der Pipeline

Get-AzBatchNodeFile -PoolId "Pool01" -ComputeNodeId "ComputeNode01" -Path "Startup\StdOut.txt" -BatchContext $Context | Get-AzBatchNodeFileContent -DestinationPath "E:\PowerShell\StdOut.txt" -BatchContext $Context

Dieser Befehl ruft die Knotendatei startup\StdOut.txt mithilfe von Get-AzBatchNodeFile aus dem Computeknoten ab, der über die ID ComputeNode01 verfügt. Der Computeknoten befindet sich im Pool mit dem ID-Pool01. Der Befehl übergibt diese Knotendatei an das aktuelle Cmdlet. Dieses Cmdlet speichert die Datei im E:\PowerShell\StdOut.txt Dateipfad auf dem lokalen Computer.

Beispiel 6: Abrufen einer Knotendatei von einem Computeknoten und Weiterleiten an einen Datenstrom

$Stream = New-Object -TypeName "System.IO.MemoryStream"
Get-AzBatchNodeFileContent -PoolId "Pool01" -ComputeNodeId "ComputeNode01" -Path "startup\stdout.txt" -DestinationStream $Stream -BatchContext $Context

Der erste Befehl erstellt einen Datenstrom mithilfe des cmdlets New-Object und speichert ihn dann in der variablen $Stream. Der zweite Befehl ruft die Knotendatei ab, die StdOut.txt aus dem Computeknoten mit der ID ComputeNode01 im Pool mit dem ID-Pool01 benannt wird. Der Befehl leitet Dateiinhalte in $Stream an den Datenstrom weiter.

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

-ByteRangeEnd

Das Ende des Bytebereichs, der heruntergeladen werden soll.

Typ:Nullable<T>[Int64]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ByteRangeStart

Der Anfang des zu herunterladenden Bytebereichs.

Typ:Nullable<T>[Int64]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComputeNodeId

Gibt die ID des Computeknotens an, der die von diesem Cmdlet zurückgegebene Knotendatei 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

-DestinationPath

Gibt den Dateipfad an, in dem dieses Cmdlet die Knotendatei speichert.

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

-DestinationStream

Gibt den Datenstrom an, in den dieses Cmdlet den Knotendateiinhalt schreibt. Mit diesem Cmdlet wird dieser Datenstrom nicht geschlossen oder zurückspulen.

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

-InputObject

Gibt die Datei an, die dieses Cmdlet abruft, als PSNodeFile--Objekt. Verwenden Sie das Cmdlet Get-AzBatchNodeFile, um ein Knotendateiobjekt abzurufen.

Typ:PSNodeFile
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

-Path

Der Pfad der herunterzuladenden Knotendatei.

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

-PoolId

Gibt die ID des Pools an, der den Computeknoten enthält, der die von diesem Cmdlet abzurufene Knotendatei enthält.

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

-TaskId

Gibt die ID des Vorgangs an.

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

Eingaben

String

PSNodeFile

BatchAccountContext

Ausgaben

Void