Get-AzBatchRemoteDesktopProtocolFile

  • Referencia
Módulo:
Az.Batch

Obtiene un archivo RDP de un nodo de proceso.

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

El cmdlet Get-AzBatchRemoteDesktopProtocolFile obtiene un archivo de Protocolo de escritorio remoto (RDP) de un nodo de proceso y lo guarda como un archivo o en una secuencia proporcionada por el usuario.

Ejemplos

Ejemplo 1: Obtener un archivo RDP de un nodo de proceso especificado y guardar el archivo

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

Este comando obtiene un archivo RDP del nodo de proceso que tiene el identificador ComputeNode01 en el grupo que tiene el id. Pool06. El comando guarda el archivo .rdp como C:\PowerShell\MyComputeNode.rdp. Use el cmdlet Get-AzBatchAccountKey para asignar un contexto a la variable $Context.

Ejemplo 2: Obtención de un archivo RDP desde un nodo de proceso y guardado del archivo mediante la canalización

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

Este comando obtiene el nodo de proceso que tiene el identificador ComputeNode02 en el grupo que tiene el id. Pool06. El comando pasa ese nodo de proceso al cmdlet actual mediante el operador de canalización. El cmdlet actual obtiene un archivo .rpd del nodo de proceso y, a continuación, guarda el contenido como un archivo denominado C:\PowerShell\MyComputeNode02.rdp.

Ejemplo 3: Obtener un archivo RDP de un nodo de proceso especificado y dirigirlo a una secuencia

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

El primer comando crea una secuencia mediante el cmdlet New-Object y, a continuación, la almacena en la variable $Stream. El segundo comando obtiene un archivo .rdp del nodo de proceso que tiene el identificador ComputeNode03 en el grupo que tiene el id. Pool06. El comando dirige el contenido del archivo a la secuencia en $Stream.

Parámetros

-BatchContext

Especifica la instancia de BatchAccountContext que usa este cmdlet para interactuar con el servicio Batch. Si usa el cmdlet Get-AzBatchAccount para obtener batchAccountContext, se usará la autenticación de Microsoft Entra al interactuar con el servicio Batch. Para usar la autenticación de clave compartida en su lugar, use el cmdlet Get-AzBatchAccountKey para obtener un objeto BatchAccountContext con sus claves de acceso rellenadas. Al usar la autenticación de clave compartida, la clave de acceso principal se usa de forma predeterminada. Para cambiar la clave que se va a usar, establezca la propiedad BatchAccountContext.KeyInUse.

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

-ComputeNode

Especifica un nodo de proceso, como un objeto PSComputeNode , al que apunta el archivo .rdp. Para obtener un objeto de nodo de proceso, use el cmdlet Get-AzBatchComputeNode.

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

-ComputeNodeId

Especifica el identificador del nodo de proceso al que apunta el archivo .rdp.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

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

-DestinationPath

Especifica la ruta de acceso del archivo donde este cmdlet guarda el archivo .rdp.

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

-DestinationStream

Especifica la secuencia en la que este cmdlet dirige los datos RDP. Este cmdlet no cierra ni rebobina esta secuencia.

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

-PoolId

Especifica el identificador del grupo que contiene el nodo de proceso desde el que este cmdlet obtiene un archivo .rdp.

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

Entradas

String

PSComputeNode

BatchAccountContext

Salidas

Void