Get-AzureRemoteDesktopFile

Referenz

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 Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

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:

Fortsetzen
Ignorieren
Inquire
SilentlyContinue
Beenden
Angehalten

Typ:	ActionPreference
Aliase:	infa
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:	String
Aliase:	iv
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Launch

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

Typ:	SwitchParameter
Position:	3
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-LocalPath

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

Typ:	String
Position:	2
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

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

Typ:	String
Aliase:	InstanceName
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Profile

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

Typ:	AzureSMProfile
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServiceName

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

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

Freigeben über