Get-AzureRemoteDesktopFile

參考

模組:: Azure

取得 Azure 虛擬機的 RDP 檔案。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM）資源的建議 PowerShell 模組。

語法

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
停止
暫止

類型:	ActionPreference
別名:	infa
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InformationVariable

指定資訊變數。

類型:	String
別名:	iv
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Launch

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

類型:	SwitchParameter
Position:	3
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-LocalPath

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

類型:	String
Position:	2
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

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

類型:	String
別名:	InstanceName
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Profile

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

類型:	AzureSMProfile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServiceName

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

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

共用方式為