Dela via


Get-AzBatchRemoteDesktopProtocolFile

Hämtar en RDP-fil från en beräkningsnod.

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

Description

Get-AzBatchRemoteDesktopProtocolFile cmdlet hämtar en RDP-fil (Remote Desktop Protocol) från en beräkningsnod och sparar den som en fil eller till en dataström från en användare.

Exempel

Exempel 1: Hämta en RDP-fil från en angiven beräkningsnod och spara filen

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

Det här kommandot hämtar en RDP-fil från beräkningsnoden som har ID:t ComputeNode01 i poolen som har ID-pool06. Kommandot sparar rdp-filen som C:\PowerShell\MyComputeNode.rdp. Använd cmdleten Get-AzBatchAccountKey för att tilldela en kontext till variabeln $Context.

Exempel 2: Hämta en RDP-fil från en beräkningsnod och spara filen med hjälp av pipelinen

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

Det här kommandot hämtar beräkningsnoden som har ID ComputeNode02 i poolen som har ID-pool06. Kommandot skickar beräkningsnoden till den aktuella cmdleten med hjälp av pipelineoperatorn. Den aktuella cmdleten hämtar en .rpd-fil från beräkningsnoden och sparar sedan innehållet som en fil med namnet C:\PowerShell\MyComputeNode02.rdp.

Exempel 3: Hämta en RDP-fil från en angiven beräkningsnod och dirigera den till en dataström

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

Det första kommandot skapar en ström med hjälp av cmdleten New-Object och lagrar den sedan i variabeln $Stream. Det andra kommandot hämtar en .rdp-fil från beräkningsnoden som har ID:t ComputeNode03 i poolen som har ID-poolen06. Kommandot dirigerar filinnehållet till strömmen i $Stream.

Parametrar

-BatchContext

Anger BatchAccountContext instans som den här cmdleten använder för att interagera med Batch-tjänsten. Om du använder cmdleten Get-AzBatchAccount för att hämta BatchAccountContext används Microsoft Entra-autentisering när du interagerar med Batch-tjänsten. Om du vill använda autentisering med delad nyckel i stället använder du cmdleten Get-AzBatchAccountKey för att hämta ett BatchAccountContext-objekt med dess åtkomstnycklar ifyllda. När du använder autentisering med delad nyckel används den primära åtkomstnyckeln som standard. Om du vill ändra vilken nyckel som ska användas anger du egenskapen BatchAccountContext.KeyInUse.

Typ:BatchAccountContext
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputeNode

Anger en beräkningsnod som ett PSComputeNode- objekt som .rdp-filen pekar på. Om du vill hämta ett beräkningsnodobjekt använder du cmdleten Get-AzBatchComputeNode.

Typ:PSComputeNode
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputeNodeId

Anger ID:t för beräkningsnoden som .rdp-filen pekar på.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestinationPath

Anger den filsökväg där den här cmdleten sparar .rdp-filen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestinationStream

Anger den ström som den här cmdleten dirigerar RDP-data till. Den här cmdleten stänger eller spolar inte tillbaka strömmen.

Typ:Stream
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PoolId

Anger ID:t för poolen som innehåller beräkningsnoden från vilken den här cmdleten hämtar en .rdp-fil.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

PSComputeNode

BatchAccountContext

Utdata

Void