Get-AzBatchRemoteDesktopProtocolFile

Obtiene un archivo RDP de un nodo de proceso.

Sintaxis

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.

Tipo:BatchAccountContext
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:PSComputeNode
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ComputeNodeId

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

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DestinationPath

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DestinationStream

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

Tipo:Stream
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PoolId

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

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

PSComputeNode

BatchAccountContext

Salidas

Void