Udostępnij za pośrednictwem


Get-AzureRemoteDesktopFile

Pobiera plik RDP dla maszyny wirtualnej platformy Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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

Opis

Polecenie cmdlet Get-AzureRemoteDesktopFile pobiera i zapisuje plik połączenia pulpitu zdalnego (RDP) dla maszyny wirtualnej platformy Azure. Polecenie cmdlet może uruchomić połączenie pulpitu zdalnego z określoną maszyną wirtualną.

Przykłady

Przykład 1. Pobieranie pliku RDP

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

To polecenie pobiera plik RDP dla maszyny wirtualnej VirtualMachine07 o nazwie VirtualMachine07, który działa w usłudze o nazwie ContosoService. Polecenie przechowuje ten plik jako C:\temp\VirtualMachine07.rdp.

Przykład 2. Uruchamianie sesji zdalnej

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

To polecenie pobiera plik RDP dla maszyny wirtualnej VirtualMachine07 o nazwie VirtualMachine07, który działa w usłudze o nazwie ContosoService. Polecenie uruchamia sesję pulpitu zdalnego. Polecenie usuwa plik RDP po zamknięciu połączenia.

Parametry

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

  • Kontynuuj
  • Ignoruj
  • Zapytać
  • SilentlyContinue
  • Zatrzymaj
  • Wstrzymanie
Typ:ActionPreference
Aliases:infa
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Określa zmienną informacyjną.

Typ:String
Aliases:iv
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-Launch

Wskazuje, że to polecenie cmdlet uruchamia sesję pulpitu zdalnego na maszynie wirtualnej.

Typ:SwitchParameter
Position:3
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-LocalPath

Określa pełną ścieżkę pobranego pliku RDP na komputerze lokalnym.

Typ:String
Position:2
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa maszynę wirtualną, dla której to polecenie cmdlet pobiera plik RDP.

Typ:String
Aliases:InstanceName
Position:1
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:AzureSMProfile
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

Określa nazwę usługi platformy Azure, do której należy maszyna wirtualna.

Typ:String
Position:0
wartość domyślna:None
Wymagane:True
Accept pipeline input:True
Accept wildcard characters:False