Get-AzureRemoteDesktopFile
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
Download (Standardwert)
Get-AzureRemoteDesktopFile
[-Name] <String>
[-LocalPath] <String>
[-ServiceName] <String>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Launch
Get-AzureRemoteDesktopFile
[-Name] <String>
[[-LocalPath] <String>]
[-ServiceName] <String>
[-Launch]
[-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
Parametereigenschaften
| Typ: | ActionPreference |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | infa |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InformationVariable
Gibt eine Informationsvariable an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Iv |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Launch
Gibt an, dass dieses Cmdlet eine Remotedesktopsitzung auf dem virtuellen Computer startet.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Launch
| Position: | 3 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-LocalPath
Gibt den vollständigen Pfad der heruntergeladenen RDP-Datei auf dem lokalen Computer an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Download
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den virtuellen Computer an, für den dieses Cmdlet eine RDP-Datei herunterlädt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | InstanzName |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
Parametereigenschaften
| Typ: | AzureSMProfile |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ServiceName
Gibt den Namen des Azure-Diensts an, zu dem der virtuelle Computer gehört.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.