Freigeben über

Get-AzBatchRemoteDesktopProtocolFile

  • Referenz
Modul:
Az.Batch

Ruft eine RDP-Datei von einem Computeknoten ab.

Syntax

Get-AzBatchRemoteDesktopProtocolFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   -DestinationPath <String>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   -DestinationStream <Stream>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [[-ComputeNode] <PSComputeNode>]
   -DestinationPath <String>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [[-ComputeNode] <PSComputeNode>]
   -DestinationStream <Stream>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-AzBatchRemoteDesktopProtocolFile ruft eine RDP-Datei (Remote Desktop Protocol) von einem Computeknoten ab und speichert sie als Datei oder in einem vom Benutzer bereitgestellten Datenstrom.

Beispiele

Beispiel 1: Abrufen einer RDP-Datei aus einem angegebenen Computeknoten und Speichern der Datei

Get-AzBatchRemoteDesktopProtocolFile -PoolId "Pool06" -ComputeNodeId "ComputeNode01" -DestinationPath "C:\PowerShell\ComputeNode01.rdp" -BatchContext $Context

Dieser Befehl ruft eine RDP-Datei aus dem Computeknoten ab, der die ID ComputeNode01 im Pool mit dem ID-Pool06 aufweist. Der Befehl speichert die RDP-Datei als C:\PowerShell\MyComputeNode.rdp. Verwenden Sie das Cmdlet Get-AzBatchAccountKey, um der variablen $Context einen Kontext zuzuweisen.

Beispiel 2: Abrufen einer RDP-Datei aus einem Computeknoten und Speichern der Datei mithilfe der Pipeline

Get-AzBatchComputeNode -PoolId "Pool06" -Id "ComputeNode02" -BatchContext $Context | Get-AzBatchRemoteDesktopProtocolFile -DestinationPath "C:\PowerShell\MyComputeNode02.rdp" -BatchContext $Context

Dieser Befehl ruft den Computeknoten ab, der über die ID ComputeNode02 im Pool mit dem ID-Pool06 verfügt. Der Befehl übergibt diesen Computeknoten mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet ruft eine RPD-Datei vom Computeknoten ab und speichert dann den Inhalt als Datei mit dem Namen "C:\PowerShell\MyComputeNode02.rdp".

Beispiel 3: Abrufen einer RDP-Datei aus einem angegebenen Computeknoten und Weiterleiten an einen Datenstrom

$Stream = New-Object -TypeName "System.IO.MemoryStream"
Get-AzBatchRemoteDesktopProtocolFile "Pool06" -ComputeNodeId "ComputeNode03" -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 eine RDP-Datei vom Computeknoten ab, der die ID ComputeNode03 im Pool mit dem ID-Pool06 enthält. 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

-ComputeNode

Gibt einen Computeknoten als PSComputeNode- -Objekt an, auf den die RDP-Datei verweist. 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, auf den die RDP-Datei verweist.

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 RDP-Datei speichert.

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

-DestinationStream

Gibt den Datenstrom an, in den dieses Cmdlet die RDP-Daten leitet. 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

-PoolId

Gibt die ID des Pools an, der den Computeknoten enthält, aus dem dieses Cmdlet eine RDP-Datei abruft.

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

Eingaben

String

PSComputeNode

BatchAccountContext

Ausgaben

Void