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.txt heißt, und speichert sie im Dateipfad "E:\PowerShell\StdOut.txt" auf dem lokalen Computer. Die StdOut.txt Knotendatei ist einer Aufgabe zugeordnet, die die ID Task01 für den Auftrag enthält, der den ID-Auftrag01 aufweist. 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 abgerufen, die mit dem Cmdlet "Get-AzBatchNodeFile" StdErr.txt benannt wird. Der Befehl übergibt diese Datei mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet speichert diese Datei im Dateipfad "E:\PowerShell\StdOut.txt" auf dem lokalen Computer. Die StdOut.txt Knotendatei ist der Aufgabe zugeordnet, die die ID Task02 für den Auftrag mit dem ID-Auftrag02 enthält.

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

Mit diesem Befehl wird die Knotendatei "Startup\StdOut.txt" aus dem Computeknoten abgerufen, der die ID ComputeNode01 im Pool mit dem ID-Pool01 enthält. Der Befehl speichert die Datei im Dateipfad "E:\PowerShell\StdOut.txt" 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

Mit diesem Befehl wird die Knotendatei "Startup\StdOut.txt" mithilfe von "Get-AzBatchNodeFile" aus dem Computeknoten abgerufen, 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. Mit diesem Cmdlet wird die Datei im Dateipfad "E:\PowerShell\StdOut.txt" auf dem lokalen Computer gespeichert.

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.

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

-ByteRangeEnd

Das Ende des Bytebereichs, der heruntergeladen werden soll.

Type:Nullable<T>[Int64]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ByteRangeStart

Der Anfang des zu herunterladenden Bytebereichs.

Type:Nullable<T>[Int64]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputeNodeId

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

-DestinationPath

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

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

-DestinationStream

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

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

-InputObject

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

Type:PSNodeFile
Position:0
Default value:None
Required:False
Accept pipeline input:True
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

-Path

Der Pfad der herunterzuladenden Knotendatei.

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

-PoolId

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

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

-TaskId

Gibt die ID des Vorgangs an.

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

Eingaben

String

PSNodeFile

BatchAccountContext

Ausgaben

Void