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.

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

-ComputeNode

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

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 RDP-Datei 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 die RDP-Daten leitet. 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

-PoolId

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

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

Eingaben

String

PSComputeNode

BatchAccountContext

Ausgaben

Void