Get-AzureRemoteDesktopFile

Módulo:

Azure

Obtém um arquivo RDP para uma máquina virtual do Azure.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do 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

O cmdlet Get-AzureRemoteDesktopFile baixa e salva um arquivo de conexão de área de trabalho remota (RDP) para uma máquina virtual do Azure. O cmdlet pode iniciar uma conexão de área de trabalho remota com a máquina virtual especificada.

Exemplos

Exemplo 1: Obter um arquivo RDP

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

Esse comando obtém um arquivo RDP para a máquina virtual VirtualMachine07 chamada VirtualMachine07 que é executada no serviço chamado ContosoService. O comando armazena esse arquivo como C:\temp\VirtualMachine07.rdp.

Exemplo 2: Iniciar uma sessão remota

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

Esse comando obtém um arquivo RDP para a máquina virtual VirtualMachine07 chamada VirtualMachine07 que é executada no serviço chamado ContosoService. O comando inicia uma sessão de área de trabalho remota. O comando exclui o arquivo RDP quando a conexão é fechada.

Parâmetros

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

• Continuar
• Ignorar
• Perguntar
• SilentlyContinue
• Stop
• Suspend

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

-InformationVariable

Especifica uma variável de informação.

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

-Launch

Indica que esse cmdlet inicia uma sessão de área de trabalho remota para a máquina virtual.

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

-LocalPath

Especifica o caminho completo do arquivo RDP baixado no computador local.

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

-Name

Especifica a máquina virtual para a qual esse cmdlet baixa um arquivo RDP.

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

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-ServiceName

Especifica o nome do serviço do Azure ao qual a máquina virtual pertence.

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