New-RDVirtualDesktopDeployment
適用対象: Windows 10, Windows Server Technical Preview
New-RDVirtualDesktopDeployment
Installs role services for Virtual Desktop Infrastructure.
構文
Parameter Set: Default
New-RDVirtualDesktopDeployment [-ConnectionBroker] <String> [-VirtualizationHost] <String[]> [[-WebAccessServer] <String> ] [[-CreateVirtualSwitch]] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]
詳細説明
The New-RDVirtualDesktopDeployment cmdlet installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. You can specify the CreateVirtualSwitch parameter to create a pooled virtual desktop collection in addition to installing the role services.
In Windows Server® 2012, the Microsoft Virtual Desktop Infrastructure (VDI) deployment is a scenario-based installation that allows you to install, configure, and manage your virtual desktops from a central location.
パラメーター
-ConnectionBroker<String>
Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for a remote desktop deployment. If you do not specify a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.
Aliases |
none |
必須/オプション |
true |
位置 |
1 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-CreateVirtualSwitch
Indicates that VDI creates a pooled virtual desktop collection that is based on a virtual hard disk of the virtual desktop template.
Aliases |
none |
必須/オプション |
false |
位置 |
4 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Aliases |
infa |
必須/オプション |
false |
位置 |
named |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
Aliases |
iv |
必須/オプション |
false |
位置 |
named |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-VirtualizationHost<String[]>
Specifies the fully qualified domain name (FQDN) of the server that you want to run the Virtualization Host (RD Virtualization Host) role service.
Aliases |
none |
必須/オプション |
true |
位置 |
2 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
-WebAccessServer<String>
Specifies the fully qualified domain name (FQDN) of the server that you want to run the Remote Desktop Web Access (RD Web Access) role service.
Aliases |
none |
必須/オプション |
false |
位置 |
3 |
既定値 |
none |
パイプライン入力の受け入れ |
false |
ワイルドカード文字の受け入れ |
false |
<CommonParameters>
このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「 「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットが出力するオブジェクトの型です。
- Null
使用例
Example 1: Create a virtual desktop deployment
This command installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. The command uses the CreateVirtualSwitch parameter to create a pooled virtual desktop collection.
PS C:\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost "rdsh.contoso.com" -CreateVirtualSwitch
Example 2: Install role services for Virtual Desktop Infrastructure
This command installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. The command installs the Remote Desktop Web Access (RD Web Access) role service on the server named rdwa.contoso.com, and installs the Virtualization Host (RD Virtualization Host) role service on the servers named rdsh-1.contoso.com and rdsh-2.contoso.com. The command does not create a pooled virtual desktop collection.
PS C:\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost @("rdsh-1.contoso.com","rdsh-2.contoso.com")