Share via


Get-AzureRemoteDesktopFile

取得 Azure 虛擬機器的 RDP 檔案。

注意

本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet,請參閱 Az 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

Get-AzureRemoteDesktopFile Cmdlet 會下載並儲存 Azure 虛擬機器的遠端桌面連線 (RDP) 檔案。 Cmdlet 可以啟動與指定虛擬機器的遠端桌面連線。

範例

範例 1:取得 RDP 檔案

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

此命令會取得名為 VirtualMachine07 的 VirtualMachine07 虛擬機器的 RDP 檔案,該虛擬機器會在名為 ContosoService 的服務上執行。 命令會將該檔案儲存為 C:\temp\VirtualMachine07.rdp。

範例 2:啟動遠端會話

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

此命令會取得名為 VirtualMachine07 的 VirtualMachine07 虛擬機器的 RDP 檔案,該虛擬機器會在名為 ContosoService 的服務上執行。 命令會啟動遠端桌面會話。 命令會在連線關閉時刪除 RDP 檔案。

參數

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為:

  • 繼續
  • 忽略
  • 詢問
  • SilentlyContinue
  • 停止
  • 暫止
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定資訊變數。

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Launch

指出此 Cmdlet 會啟動虛擬機器的遠端桌面會話。

Type:SwitchParameter
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LocalPath

指定本機電腦上所下載 RDP 檔案的完整路徑。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定此 Cmdlet 下載 RDP 檔案的虛擬機器。

Type:String
Aliases:InstanceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔,此 Cmdlet 會從本機預設設定檔讀取。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

指定虛擬機器所屬的 Azure 服務名稱。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False