Delen via

Get-AzBatchRemoteDesktopProtocolFile

  • Referentie
Module:
Az.Batch

Hiermee haalt u een RDP-bestand op van een rekenknooppunt.

Syntaxis

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>]

Description

De cmdlet Get-AzBatchRemoteDesktopProtocolFile haalt een RDP-bestand (Remote Desktop Protocol) op van een rekenknooppunt en slaat het op als een bestand of aan een door de gebruiker opgegeven stream.

Voorbeelden

Voorbeeld 1: Een RDP-bestand ophalen uit een opgegeven rekenknooppunt en het bestand opslaan

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

Met deze opdracht wordt een RDP-bestand opgehaald uit het rekenknooppunt met de id ComputeNode01 in de pool met de id-pool06. Met de opdracht wordt het RDP-bestand opgeslagen als C:\PowerShell\MyComputeNode.rdp. Gebruik de cmdlet Get-AzBatchAccountKey om een context toe te wijzen aan de variabele $Context.

Voorbeeld 2: Een RDP-bestand ophalen uit een rekenknooppunt en het bestand opslaan met behulp van de pijplijn

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

Met deze opdracht wordt het rekenknooppunt opgehaald met de id ComputeNode02 in de pool met de id-pool06. Met de opdracht wordt dat rekenknooppunt doorgegeven aan de huidige cmdlet met behulp van de pijplijnoperator. De huidige cmdlet haalt een .rpd-bestand op van het rekenknooppunt en slaat vervolgens de inhoud op als een bestand met de naam C:\PowerShell\MyComputeNode02.rdp.

Voorbeeld 3: Een RDP-bestand ophalen van een opgegeven rekenknooppunt en dit naar een stream leiden

$Stream = New-Object -TypeName "System.IO.MemoryStream"
Get-AzBatchRemoteDesktopProtocolFile "Pool06" -ComputeNodeId "ComputeNode03" -DestinationStream $Stream -BatchContext $Context

Met de eerste opdracht maakt u een stream met behulp van de cmdlet New-Object en slaat deze vervolgens op in de variabele $Stream. Met de tweede opdracht wordt een RDP-bestand opgehaald uit het rekenknooppunt met de id ComputeNode03 in de pool met de id-pool06. De opdracht stuurt de bestandsinhoud naar de stream in $Stream.

Parameters

-BatchContext

Hiermee geeft u het BatchAccountContext-exemplaar op dat door deze cmdlet wordt gebruikt om te communiceren met de Batch-service. Als u de Cmdlet Get-AzBatchAccount gebruikt om uw BatchAccountContext op te halen, wordt Microsoft Entra-verificatie gebruikt bij interactie met de Batch-service. Als u in plaats daarvan gedeelde sleutelverificatie wilt gebruiken, gebruikt u de cmdlet Get-AzBatchAccountKey om een BatchAccountContext-object op te halen waarin de bijbehorende toegangssleutels zijn ingevuld. Wanneer u verificatie met gedeelde sleutels gebruikt, wordt de primaire toegangssleutel standaard gebruikt. Als u de sleutel wilt wijzigen die u wilt gebruiken, stelt u de eigenschap BatchAccountContext.KeyInUse in.

Type:BatchAccountContext
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputeNode

Hiermee geeft u een rekenknooppunt, als een PSComputeNode-object , waarnaar het RDP-bestand verwijst. Gebruik de cmdlet Get-AzBatchComputeNode om een rekenknooppuntobject op te halen.

Type:PSComputeNode
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputeNodeId

Hiermee geeft u de id van het rekenknooppunt waarnaar het RDP-bestand verwijst.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DestinationPath

Hiermee geeft u het bestandspad waarin deze cmdlet het RDP-bestand opslaat.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DestinationStream

Hiermee geeft u de stroom op waarin met deze cmdlet de RDP-gegevens worden omgeslagen. Met deze cmdlet wordt deze stream niet gesloten of terugspoelen.

Type:Stream
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PoolId

Hiermee geeft u de id op van de pool die het rekenknooppunt bevat waaruit deze cmdlet een RDP-bestand ophaalt.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

PSComputeNode

BatchAccountContext

Uitvoerwaarden

Void