Share via

Get-AzBatchRemoteDesktopProtocolFile

  • Referência
Módulo:
Az.Batch

Obtém um arquivo RDP de um nó de computação.

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

O cmdlet Get-AzBatchRemoteDesktopProtocolFile obtém um arquivo RDP (Remote Desktop Protocol) de um nó de computação e o salva como um arquivo ou em um fluxo fornecido pelo usuário.

Exemplos

Exemplo 1: Obter um arquivo RDP de um nó de computação especificado e salvar o arquivo

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

Este comando obtém um arquivo RDP do nó de computação que tem a ID ComputeNode01 no pool que tem a ID Pool06. O comando salva o arquivo .rdp como C:\PowerShell\MyComputeNode.rdp. Use o cmdlet Get-AzBatchAccountKey para atribuir um contexto à variável $Context.

Exemplo 2: Obter um arquivo RDP de um nó de computação e salvar o arquivo usando o pipeline

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

Este comando obtém o nó de computação que tem a ID ComputeNode02 no pool que tem a ID Pool06. O comando passa esse nó de computação para o cmdlet atual usando o operador de pipeline. O cmdlet atual obtém um arquivo .rpd do nó de computação e salva o conteúdo como um arquivo chamado C:\PowerShell\MyComputeNode02.rdp.

Exemplo 3: Obter um arquivo RDP de um nó de computação especificado e direcioná-lo para um fluxo

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

O primeiro comando cria um fluxo usando o cmdlet New-Object e, em seguida, armazena-o na variável $Stream. O segundo comando obtém um arquivo .rdp do nó de computação que tem a ID ComputeNode03 no pool que tem a ID Pool06. O comando direciona o conteúdo do arquivo para o fluxo no $Stream.

Parâmetros

-BatchContext

Especifica a instância BatchAccountContext que esse cmdlet usa para interagir com o serviço Batch. Se você usar o cmdlet Get-AzBatchAccount para obter seu BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço Batch. Para usar a autenticação de chave compartilhada, use o cmdlet Get-AzBatchAccountKey para obter um objeto BatchAccountContext com suas chaves de acesso preenchidas. Ao usar a autenticação de chave compartilhada, a chave de acesso primária é usada por padrão. Para alterar a chave a ser usada, defina a propriedade BatchAccountContext.KeyInUse.

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputeNode

Especifica um nó de computação, como um objeto PSComputeNode, para o qual o arquivo .rdp aponta. Para obter um objeto de nó de computação, use o cmdlet Get-AzBatchComputeNode.

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

-ComputeNodeId

Especifica a ID do nó de computação para o qual o arquivo .rdp aponta.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

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

-DestinationPath

Especifica o caminho do arquivo onde esse cmdlet salva o arquivo .rdp.

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

-DestinationStream

Especifica o fluxo para o qual esse cmdlet direciona os dados RDP. Este cmdlet não fecha nem retrocede esse fluxo.

Type:Stream
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PoolId

Especifica a ID do pool que contém o nó de computação do qual esse cmdlet obtém um arquivo .rdp.

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

Entradas

String

PSComputeNode

BatchAccountContext

Saídas

Void