New-QVWComputer (7.2.303.0278)
From VWorkspace
Creates new computers within the specified computer group.
Syntax
New-QVWComputer [-ComputerGroup] <Object> [[-Location] <String>] [[-Farm] <Object>] [[-NumberToCreate] <Int32>] [[-CreateMaxPossible]] [-WhatIf] [-Confirm] [-UseTransaction] [<CommonParameters>]
Description
Creates one or more computers within the specified computer group, according to the existing provisioning settings in the group. Before creating computers in a group, all the group's provisioning settings must be specified and valid. See Set-QVWProvisioningSettings for more information.
Parameters
| Name | Position | Required | Type | Description | Pipeline Input | Default Value |
|---|---|---|---|---|---|---|
| ComputerGroup | 2 | Yes | Object | The computer group within which the new computers will be created. | Yes (ByValue) | |
| Location | 3 | No | String | The name of the vWorkspace location in which the computer group resides. Specify this value if the name of the computer group is not unique across locations. | No | |
| Farm | 4 | No | Object | The vWorkspace farm against which this cmdlet will execute. You may specify a farm's local alias, GUID, or QVWFarm object. If the farm is not specified, the cmdlet will operate on the current PowerShell drive, which must be a vWorkspace farm. To change to a vWorkspace farm, type Set-Location farmname:. | No | |
| NumberToCreate | 5 | No | Int32 | The number of computers to create. You may create up to 1,000 computers at a time. The group's current naming conventions and provisioning settings are used to create the new computers.
If this parameter is not specified, one computer will be created. | No | |
| CreateMaxPossible | 6 | No | SwitchParameter | Specifies that the cmdlet should create the maximum number of computers possible, even when errors are generated during execution. These errors may be the result of a lack of storage space or computer names (based on the specified naming conventions). | No | |
| Confirm | named | No | SwitchParameter | Prompts for confirmation before modifying data. Overrides the $ConfirmPreference variable. | No | |
| WhatIf | named | No | SwitchParameter | Displays the result of the cmdlet without modifying any data. | No | |
| UseTransaction | named | No | SwitchParameter | Indicates that this cmdlet should participate in an existing transaction, if there is one available. | No | |
| <CommonParameters> | This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer and OutVariable. For more information, type, "get-help about_commonparameters". |
Return Values
Related Commands
Examples
Example 1
Creates a single computer within the computer group SCVMM and farm vWorkspaceFarm.
New-QVWComputer -ComputerGroup "SCVMM" -Farm vWorkspaceFarm
Example 2
Creates five computers within the computer group VMware in the farm vWorkspaceFarm.
New-QVWComputer -ComputerGroup VMware -Farm vWorkspaceFarm -NumberToCreate 5
Example 3
Attempts to create 50 computers within the computer group SCVMM in the farm vWorkspaceFarm. If the naming conventions or storage space do not allow for all 50 to be generated then the maximum number possible will be created.
Always check with your virtual infrastructure manufacturer for proper sizing and capacity guidelines before creating virtual machines.
New-QVWComputer -ComputerGroup SCVMM -Farm vWorkspaceFarm -NumberToCreate 50 -CreateMaxPossible
Back to Main Page
