Dela via

Get-AzBatchRemoteDesktopProtocolFile

  • Referens
Modul:
Az.Batch

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

Cmdleten Get-AzBatchRemoteDesktopProtocolFile 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 användaren.

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 den 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.

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-ComputeNodeId

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

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

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPath

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Stream
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

Indata

String

PSComputeNode

BatchAccountContext

Utdata

Void