< Back
New-RDVirtualDesktopDeployment
Post
NAME New-RDVirtualDesktopDeployment
SYNOPSIS
Installs role services for Virtual Desktop Infrastructure.
SYNTAX
New-RDVirtualDesktopDeployment [-ConnectionBroker] <String> [-VirtualizationHost] <String[]> [[-WebAccessServer] <String>]
[[-CreateVirtualSwitch]] [<CommonParameters>]
DESCRIPTION
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.
PARAMETERS
-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.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CreateVirtualSwitch [<SwitchParameter>]
Indicates that VDI creates a pooled virtual desktop collection that is based on a virtual hard disk of the virtual desktop template.
Required? false
Position? 4
Default value none
Accept pipeline input? false
Accept wildcard characters? 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.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? 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.
Required? false
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Null
Example 1: Create a virtual desktop deployment
PS C:\\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost
"rdsh.contoso.com" -CreateVirtualSwitch
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.
Example 2: Install role services for Virtual Desktop Infrastructure
PS C:\\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost
@("rdsh-1.contoso.com","rdsh-2.contoso.com")
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294243
New-RDSessionDeployment
SYNOPSIS
Installs role services for Virtual Desktop Infrastructure.
SYNTAX
New-RDVirtualDesktopDeployment [-ConnectionBroker] <String> [-VirtualizationHost] <String[]> [[-WebAccessServer] <String>]
[[-CreateVirtualSwitch]] [<CommonParameters>]
DESCRIPTION
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.
PARAMETERS
-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.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-CreateVirtualSwitch [<SwitchParameter>]
Indicates that VDI creates a pooled virtual desktop collection that is based on a virtual hard disk of the virtual desktop template.
Required? false
Position? 4
Default value none
Accept pipeline input? false
Accept wildcard characters? 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.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? 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.
Required? false
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Null
Example 1: Create a virtual desktop deployment
PS C:\\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost
"rdsh.contoso.com" -CreateVirtualSwitch
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.
Example 2: Install role services for Virtual Desktop Infrastructure
PS C:\\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost
@("rdsh-1.contoso.com","rdsh-2.contoso.com")
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=294243
New-RDSessionDeployment