The Add-CVVirtualMachineGroupContent
cmdlet allows you to preview the content of a VM group and creates clients from the result set.
Before you can use this cmdlet, you must log on to your CommCell environment using the Connect-CVServer
cmdlet. For more information, see Connecting to a CommCell Environment with PowerShell.
Syntax
Add-CVVirtualMachineGroupContent -SubclientObject <Object> -EntityType {Host | Datastore | VMName | VMNamePattern | GuestOS | GuestDNSHostname | PoweredState | Notes | TemplateState | Tag | TagCategory} [-PoweredState {Off | On | Other}] [-TemplateState <Boolean>] [-MatchingPattern {Contains | Equals | StartsWith | EndsWith}] [-DisplayName <String>] [-VMName <String>] [-CreateClientsForDiscoveredVms] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
Required Parameters
Parameter | Description | Data type | Values | Accepts pipeline input? | Accepts wildcard characters? | Type of parameter |
---|---|---|---|---|---|---|
| An object that represents a VM group that you want to preview the content for. | Object | Yes, by:
| No | Named | |
| The entity type of the virtual server. | Valid values are:
| No | No | Named |
Optional Parameters
Commvault Parameters
Parameter | Description | Data type | Values | Accepts pipeline input? | Accepts wildcard characters? | Type of parameter |
---|---|---|---|---|---|---|
| The state of the entity type. | Valid values are:
| No | No | Named | |
| The template state of the entity type. | Boolean | Valid values are:
| No | No | Named |
| The matching pattern to perform a search on the Display Name parameter. | Valid values are:
| Yes, by:
| No | Named | |
| The term used to perform a search. | String | No | No | Named | |
| The GUID of the VM. | String | No | No | Named | |
| The toggle key that indicates whether to create clients for discovered VMs. Before you create clients, preview discovery results. | Switch Parameter | The default value is False. | No | No | Named |
Microsoft PowerShell Parameters
You can use the following Microsoft PowerShell parameters:
Debug
ErrorAction
ErrorVariable
OutBuffer
OutVariable
PipelineVariable
Verbose
WarningAction
WarningVariable
Force
Confirm
WhatIf
Note: Only a few cmdlets support Force, Confirm, and WhatIf parameters.
For more information, see "About Common Parameters" in the Microsoft PowerShell documentation.
Input
This cmdlet does not support input.
Output
A PSCustomObject that contains VM discovery results.
Example
This example previews the content of the GRS-VMGroup VM with Datastore entity type.
Get-CVSubclient -Name GRS-VMGroup1 -ClientName accounting.mycompany.com | Add-CVVirtualMachineGroupContent -EntityType Datastore -MatchingPattern EndsWith -DisplayName DS1