Condividi tramite


Get-AzBatchRemoteDesktopProtocolFile

Ottiene un file RDP da un nodo di calcolo.

Sintassi

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

Descrizione

Il cmdlet Get-AzBatchRemoteDesktopProtocolFile ottiene un file RDP (Remote Desktop Protocol) da un nodo di calcolo e lo salva come file o in un flusso fornito dall'utente.

Esempio

Esempio 1: Ottenere un file RDP da un nodo di calcolo specificato e salvare il file

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

Questo comando ottiene un file RDP dal nodo di calcolo con ID ComputeNode01 nel pool con ID Pool06. Il comando salva il file con estensione rdp come C:\PowerShell\MyComputeNode.rdp. Usare il cmdlet Get-AzBatchAccountKey per assegnare un contesto alla variabile $Context.

Esempio 2: Ottenere un file RDP da un nodo di calcolo e salvare il file usando la pipeline

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

Questo comando ottiene il nodo di calcolo con ID ComputeNode02 nel pool con ID Pool06. Il comando passa il nodo di calcolo al cmdlet corrente usando l'operatore pipeline. Il cmdlet corrente ottiene un file con estensione rpd dal nodo di calcolo e quindi salva il contenuto come file denominato C:\PowerShell\MyComputeNode02.rdp.

Esempio 3: Ottenere un file RDP da un nodo di calcolo specificato e indirizzarlo a un flusso

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

Il primo comando crea un flusso usando il cmdlet New-Object e quindi lo archivia nella variabile $Stream. Il secondo comando ottiene un file rdp dal nodo di calcolo con ID ComputeNode03 nel pool con ID Pool06. Il comando indirizza il contenuto del file al flusso in $Stream.

Parametri

-BatchContext

Specifica l'istanza batchAccountContext usata da questo cmdlet per interagire con il servizio Batch. Se si usa il cmdlet Get-AzBatchAccount per ottenere BatchAccountContext, l'autenticazione di Microsoft Entra verrà usata durante l'interazione con il servizio Batch. Per usare invece l'autenticazione con chiave condivisa, usare il cmdlet Get-AzBatchAccountKey per ottenere un oggetto BatchAccountContext con le relative chiavi di accesso popolate. Quando si usa l'autenticazione con chiave condivisa, la chiave di accesso primaria viene usata per impostazione predefinita. Per modificare la chiave da usare, impostare la proprietà BatchAccountContext.KeyInUse.

Tipo:BatchAccountContext
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputeNode

Specifica un nodo di calcolo, come oggetto PSComputeNode , a cui punta il file con estensione rdp. Per ottenere un oggetto nodo di calcolo, usare il cmdlet Get-AzBatchComputeNode.

Tipo:PSComputeNode
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputeNodeId

Specifica l'ID del nodo di calcolo a cui punta il file rdp.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationPath

Specifica il percorso del file in cui questo cmdlet salva il file con estensione rdp.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationStream

Specifica il flusso in cui questo cmdlet indirizza i dati RDP. Questo cmdlet non chiude o riavvolge questo flusso.

Tipo:Stream
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PoolId

Specifica l'ID del pool che contiene il nodo di calcolo da cui questo cmdlet ottiene un file rdp.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

PSComputeNode

BatchAccountContext

Output

Void