Get-AzureRemoteDesktopFile

Modul:

Azure

Ruft eine RDP-Datei für einen virtuellen Azure-Computer ab.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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>]

Beschreibung

Das Cmdlet Get-AzureRemoteDesktopFile lädt eine RDP-Datei (RemoteDesktopverbindung) für einen virtuellen Azure-Computer herunter und speichert sie. Das Cmdlet kann eine Remotedesktopverbindung mit dem angegebenen virtuellen Computer starten.

Beispiele

Beispiel 1: Abrufen einer RDP-Datei

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

Dieser Befehl ruft eine RDP-Datei für den virtuellen Computer VirtualMachine07 mit dem Namen VirtualMachine07 ab, der auf dem Dienst "ContosoService" ausgeführt wird. Der Befehl speichert diese Datei als C:\temp\VirtualMachine07.rdp.

Beispiel 2: Starten einer Remotesitzung

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

Dieser Befehl ruft eine RDP-Datei für den virtuellen Computer VirtualMachine07 mit dem Namen VirtualMachine07 ab, der auf dem Dienst "ContosoService" ausgeführt wird. Der Befehl startet eine Remotedesktopsitzung. Der Befehl löscht die RDP-Datei, wenn die Verbindung geschlossen wird.

Parameter

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

• Fortfahren
• Ignorieren
• Fragen
• SilentlyContinue
• Beenden
• Angehalten

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

-InformationVariable

Gibt eine Informationsvariable an.

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

-Launch

Gibt an, dass dieses Cmdlet eine Remotedesktopsitzung auf dem virtuellen Computer startet.

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

-LocalPath

Gibt den vollständigen Pfad der heruntergeladenen RDP-Datei auf dem lokalen Computer an.

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

-Name

Gibt den virtuellen Computer an, für den dieses Cmdlet eine RDP-Datei herunterlädt.

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

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

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

-ServiceName

Gibt den Namen des Azure-Diensts an, zu dem der virtuelle Computer gehört.

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