Dela via


Get-AzureRemoteDesktopFile

Hämtar en RDP-fil för en virtuell Azure-dator.

Kommentar

De cmdletar som refereras i den här dokumentationen används för att hantera äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning. Mer information finns i Azure Service Manager-tillbakadragning.

Az PowerShell-modulen är den rekommenderade PowerShell-modulen för hantering av Arm-resurser (Azure Resource Manager) med 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>]

Description

Cmdleten Get-AzureRemoteDesktopFile laddar ned och sparar en RDP-fil (Remote Desktop Connection) för en virtuell Azure-dator. Cmdleten kan starta en fjärrskrivbordsanslutning till den angivna virtuella datorn.

Exempel

Exempel 1: Hämta en RDP-fil

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

Det här kommandot hämtar en RDP-fil för den virtuella datorn VirtualMachine07 med namnet VirtualMachine07 som körs på tjänsten ContosoService. Kommandot lagrar filen som C:\temp\VirtualMachine07.rdp.

Exempel 2: Starta en fjärrsession

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

Det här kommandot hämtar en RDP-fil för den virtuella datorn VirtualMachine07 med namnet VirtualMachine07 som körs på tjänsten ContosoService. Kommandot startar en fjärrskrivbordssession. Kommandot tar bort RDP-filen när anslutningen stängs.

Parametrar

-InformationAction

Anger hur den här cmdleten svarar på en informationshändelse.

De acceptabla värdena för den här parametern är:

  • Fortsätt
  • Ignorera
  • Fråga
  • TystKontinuera
  • Stoppa
  • Suspend
Typ:ActionPreference
Alias:infa
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InformationVariable

Anger en informationsvariabel.

Typ:String
Alias:iv
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Launch

Anger att den här cmdleten startar en fjärrskrivbordssession till den virtuella datorn.

Typ:SwitchParameter
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LocalPath

Anger den fullständiga sökvägen till den nedladdade RDP-filen på den lokala datorn.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger den virtuella dator som den här cmdleten laddar ned en RDP-fil för.

Typ:String
Alias:InstanceName
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Profile

Anger den Azure-profil som den här cmdleten läser från. Om du inte anger någon profil läser den här cmdleten från den lokala standardprofilen.

Typ:AzureSMProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServiceName

Anger namnet på den Azure-tjänst som den virtuella datorn tillhör.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False