Get-AzureRemoteDesktopFile

Módulo:

Azure

Obtiene un archivo RDP para una máquina virtual de Azure.

Nota

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan Service Management API. Consulte el módulo de Az PowerShell para cmdlets para administrar recursos de Azure Resource Manager.

Syntax

Get-AzureRemoteDesktopFile
   [-Name] <String>
   [-LocalPath] <String>
   [-ServiceName] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Get-AzureRemoteDesktopFile
   [-Name] <String>
   [[-LocalPath] <String>]
   [-Launch]
   [-ServiceName] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureRemoteDesktopFile descarga y guarda un archivo de conexión a Escritorio remoto (RDP) para una máquina virtual de Azure. El cmdlet puede iniciar una conexión de Escritorio remoto a la máquina virtual especificada.

Ejemplos

Ejemplo 1: Obtener un archivo RDP

PS C:\> Get-AzureRemoteDesktopFile -ServiceName "ContosoService" -Name "VirtualMachine07" -LocalPath "C:\temp\VirtualMachine07.rdp"

Este comando obtiene un archivo RDP para la máquina virtual VirtualMachine07 denominada VirtualMachine07 que se ejecuta en el servicio denominado ContosoService. El comando almacena ese archivo como C:\temp\VirtualMachine07.rdp.

Ejemplo 2: Iniciar una sesión remota

PS C:\> Get-AzureRemoteDesktopFile -ServiceName "ContosoService" -Name "VirtualMachine07" -Launch

Este comando obtiene un archivo RDP para la máquina virtual VirtualMachine07 denominada VirtualMachine07 que se ejecuta en el servicio denominado ContosoService. El comando inicia una sesión de Escritorio remoto. El comando elimina el archivo RDP cuando se cierra la conexión.

Parámetros

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

• Continuar
• Ignore
• Inquire
• SilentlyContinue
• Stop
• Suspender

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Especifica una variable de información.

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

-Launch

Indica que este cmdlet inicia una sesión de Escritorio remoto en la máquina virtual.

Type:	SwitchParameter
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LocalPath

Especifica la ruta de acceso completa del archivo RDP descargado en el equipo local.

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

-Name

Especifica la máquina virtual para la que este cmdlet descarga un archivo RDP.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-ServiceName

Especifica el nombre del servicio de Azure al que pertenece la máquina virtual.

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