< Back

New-DrsClusterGroup

Sun Jan 19, 2020 6:59 pm

NAME New-DrsClusterGroup



SYNOPSIS

This cmdlet creates either a VM or VM host DRS cluster group, depending on the used parameter set.





SYNTAX

New-DrsClusterGroup [-Name] <String> [-Cluster] <Cluster> [-VM] <VirtualMachine[]> [-RunAsync] [-Server

<VIServer[]>] [-Confirm] [-WhatIf] [<CommonParameters>]



New-DrsClusterGroup [-Name] <String> [-Cluster] <Cluster> [-VMHost] <VMHost[]> [-RunAsync] [-Server <VIServer[]>]

[-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

This cmdlet creates either a VM or VM host DRS cluster group, depending on the used parameter set.





PARAMETERS

-Cluster <Cluster>

Specifies the cluster on which you want to create the new DRS cluster group.



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? true



-Name <String>

Specifies the name for the new DRS cluster group.



Required? true

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-RunAsync [<SwitchParameter>]

Indicates that the command returns immediately without waiting for the task to complete. In this mode, the

output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help

About_RunAsync" in the VMware PowerCLI console.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Server <VIServer[]>

Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this

parameter, the command runs on the default servers. For more information about default servers, see the

description of Connect-VIServer.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? true



-VM <VirtualMachine[]>

Specifies the virtual machines which you want to add to the new VM DRS cluster group.



Required? true

Position? 3

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-VMHost <VMHost[]>

Specifies the VM hosts which you want to add to the new VMHost DRS cluster group.



Required? true

Position? 3

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false,

the cmdlet runs without asking for user confirmation.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are

modified.



Required? false

Position? named

Default value False

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 (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

The newly created DrsClusterGroup object







NOTES









-------------------------- Example 1 --------------------------



New-DrsClusterGroup -Name "MyDrsClusterGroup" -VM "MyVM1", "MyVM2" -Cluster "MyCluster"



Creates a VM DRS cluster group in the "MyCluster" cluster by adding a list of virtual machines inside.



RELATED LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... Group.html

Get-DrsClusterGroup

Remove-DrsClusterGroup

Set-DrsClusterGroup