PowerShell Logo Small

New-RDVirtualDesktopCollection



This is the built-in help made by Microsoft for the command 'New-RDVirtualDesktopCollection', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Creates a new virtual desktop collection.

SYNTAX


New-RDVirtualDesktopCollection [-CollectionName] <String> [-AutoAssignPersonalVirtualDesktopToUser] [-ConnectionBroker <String>] [-Description <String>] [-Force]
[-GrantAdministrativePrivilege] [-UserGroups <String[]>] -PersonalUnmanaged -VirtualDesktopName <String[]> [<CommonParameters>]
New-RDVirtualDesktopCollection [-CollectionName] <String> [-AutoAssignPersonalVirtualDesktopToUser] [-CentralStoragePath <String>] [-ConnectionBroker <String>]
[-CustomSysprepUnattendFilePath <String>] [-Description <String>] [-Domain <String>] [-Force] [-GrantAdministrativePrivilege] [-LocalStoragePath <String>] [-OU <String>]
[-UserGroups <String[]>] [-VirtualDesktopNamePrefix <String>] -PersonalManaged -StorageType <VirtualDesktopStorageType> -VirtualDesktopAllocation <Hashtable>
-VirtualDesktopTemplateHostServer <String> -VirtualDesktopTemplateName <String> [<CommonParameters>]
New-RDVirtualDesktopCollection [-CollectionName] <String> [-CentralStoragePath <String>] [-ConnectionBroker <String>] [-CustomSysprepUnattendFilePath <String>] [-Description
<String>] [-DisableVirtualDesktopRollback] [-Domain <String>] [-Force] [-LocalStoragePath <String>] [-MaxUserProfileDiskSizeGB <Int32>] [-OU <String>] [-UserGroups
<String[]>] [-UserProfileDiskPath <String>] [-VirtualDesktopNamePrefix <String>] [-VirtualDesktopPasswordAge <Int32>] [-VirtualDesktopTemplateStoragePath <String>]
-PooledManaged -StorageType <VirtualDesktopStorageType> -VirtualDesktopAllocation <Hashtable> -VirtualDesktopTemplateHostServer <String> -VirtualDesktopTemplateName <String>
[<CommonParameters>]
New-RDVirtualDesktopCollection [-CollectionName] <String> [-ConnectionBroker <String>] [-Description <String>] [-Force] [-MaxUserProfileDiskSizeGB <Int32>] [-UserGroups
<String[]>] [-UserProfileDiskPath <String>] -PooledUnmanaged -VirtualDesktopName <String[]> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-RDVirtualDesktopCollection cmdlet creates a new virtual desktop collection.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294242
Get-RDVirtualDesktopCollection
Update-RDVirtualDesktopCollection
Remove-RDVirtualDesktopCollection

REMARKS

<

Examples


Example 1: Create a managed pooled virtual desktop collection

PS C:\> New-RDVirtualDesktopCollection -CollectionName "Virtual Desktop Pool" -PooledManaged -VirtualDesktopTemplateName "RDS-Template" -VirtualDesktopTemplateHostServer
"rdvh-1.contoso.com" -VirtualDesktopAllocation @{"RDS-WKS-A26.contoso.com"=1;" RDS-WKS-A27.contoso.com"=2} -StorageType LocalStorage -Description "PowerShell created Virtual
Desktop Pool" -UserGroups "contoso\domain users" -ConnectionBroker "rdcb.contoso.com" -VirtualDesktopNamePrefix "RDS-WKS-A" -VirtualDesktopPasswordAge 31
-UserProfileDiskPath "\\RDS-WKS-A26.contoso.com\uvhd" -MaxUserProfileDiskSizeGB 10



This command creates a managed pooled virtual desktop collection and specifies configuration settings for the virtual desktop collection. The command specifies the
LocalStorage type for the collection, and specifies the virtual desktop template named "RDS-Template" for the collection.