New-WmsVirtualDesktop
Creates a virtual desktop.
Syntax
New-WmsVirtualDesktop
[-StationId] <UInt32[]>
-InputFilePath <String>
[-VhdLocation <String>]
-TemplatePrefix <String>
[-Domain <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-WmsVirtualDesktop
[-All]
-InputFilePath <String>
[-VhdLocation <String>]
-TemplatePrefix <String>
[-Domain <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
The New-WmsVirtualDesktop cmdlet creates a virtual desktop from the specified virtual desktop template for a specified MultiPoint station or all stations, and replaces any existing stations in the process.
Examples
Example 1: Create a virtual desktop for all stations on a computer
PS C:\> New-WmsVirtualDesktop -All -InputFilePath "C:\Images\Windows10Enterprise.iso" -TemplatePrefix "MyVdiImage" -VhdLocation "C:\MultiPointVhdImages"This command creates a virtual desktop from the template in C:\Images\Windows10Enterprise.iso for all of the stations on a computer.
Parameters
-All
Indicates that this operation creates a virtual desktop for all stations.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Domain
Specifies the name of the Active Directory domain to contain the virtual desktop.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputFilePath
Specifies the full path of the input file to use for the virtual desktop template. Valid file types are .wim, .iso, or .vhd that contains the version of Windows to use as the guest operating system.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StationId
Specifies an array of station IDs for which to create a virtual desktop.
| Type: | UInt32[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplatePrefix
Specifies the prefix to use for the name of the virtual machine template.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VhdLocation
Specifies the path to store the template and station .vhd files.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None
Outputs
None