Condividi tramite

Get-AzBatchRemoteDesktopProtocolFile

  • Riferimento
Modulo:
Az.Batch

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
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters: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
Position:0
valore predefinito:None
Necessario:False
Accept pipeline input:True
Accept wildcard characters:False

-ComputeNodeId

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

Tipo:String
Position:1
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valore predefinito:None
Necessario:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPath

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

Tipo:String
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:False
Accept wildcard characters:False

-DestinationStream

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

Tipo:Stream
Position:Named
valore predefinito:None
Necessario:True
Accept pipeline input:False
Accept wildcard characters:False

-PoolId

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

Tipo:String
Position:0
valore predefinito:None
Necessario:True
Accept pipeline input:True
Accept wildcard characters:False

Input

String

PSComputeNode

BatchAccountContext

Output

Void