Delen via


Get-AzureRemoteDesktopFile

Hiermee haalt u een RDP-bestand op voor een virtuele Azure-machine.

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

Syntaxis

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

De cmdlet Get-AzureRemoteDesktopFile downloadt en slaat een RDP-bestand (Remote Desktop Connection) op voor een virtuele Azure-machine. De cmdlet kan een verbinding met een extern bureaublad met de opgegeven virtuele machine starten.

Voorbeelden

Voorbeeld 1: Een RDP-bestand ophalen

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

Met deze opdracht wordt een RDP-bestand voor de virtuele machine VirtualMachine07 met de naam VirtualMachine07 ophaalt die wordt uitgevoerd op de service ContosoService. Met de opdracht wordt dat bestand opgeslagen als C:\temp\VirtualMachine07.rdp.

Voorbeeld 2: Een externe sessie starten

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

Met deze opdracht wordt een RDP-bestand voor de virtuele machine VirtualMachine07 met de naam VirtualMachine07 ophaalt die wordt uitgevoerd op de service ContosoService. Met de opdracht wordt een extern bureaubladsessie gestart. Met de opdracht wordt het RDP-bestand verwijderd wanneer de verbinding is gesloten.

Parameters

-InformationAction

Hiermee geeft u op hoe deze cmdlet reageert op een informatie-gebeurtenis.

De aanvaardbare waarden voor deze parameter zijn:

  • Verdergaan
  • Negeren
  • Vragen
  • SilentlyContinue
  • Stoppen
  • Onderbreken
Type:ActionPreference
Aliassen:infa
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InformationVariable

Hiermee geeft u een informatievariabele op.

Type:String
Aliassen:iv
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Launch

Geeft aan dat met deze cmdlet een extern bureaubladsessie naar de virtuele machine wordt gestart.

Type:SwitchParameter
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LocalPath

Hiermee geeft u het volledige pad van het gedownloade RDP-bestand op de lokale computer.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de virtuele machine waarvoor deze cmdlet een RDP-bestand downloadt.

Type:String
Aliassen:InstanceName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Profile

Hiermee geeft u het Azure-profiel op waaruit deze cmdlet wordt gelezen. Als u geen profiel opgeeft, leest deze cmdlet uit het lokale standaardprofiel.

Type:AzureSMProfile
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServiceName

Hiermee geeft u de naam op van de Azure-service waartoe de virtuele machine behoort.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False