Get-AzureRemoteDesktopFile

Módulo:

Azure

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

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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"

Este comando obtém um arquivo RDP para a máquina virtual VirtualMachine07 chamada VirtualMachine07 que é executado 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

Este comando obtém um arquivo RDP para a máquina virtual VirtualMachine07 chamada VirtualMachine07 que é executado 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ção.

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

• Continuar
• Ignorar
• Informe-se
• SilenciosamenteContinue
• Parar
• Suspender

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 na 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 é lido. 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