Set-SCPlacementConfiguration

Set-SCPlacementConfiguration

Sets the placement configuration settings for a host group.

構文

Parameter Set: SetToFavor
Set-SCPlacementConfiguration -Favor -PlacementConfiguration <PlacementConfigurationSettings> [-DVDDriveRequirement] [-JobVariable <String> ] [-LoadBalancerRequirement] [-NetworkRequirement] [-PassthroughDiskRequirement] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-VMQueueAvailability] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetToInherit
Set-SCPlacementConfiguration -Inherit <Boolean> -PlacementConfiguration <PlacementConfigurationSettings> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetToMustMeet
Set-SCPlacementConfiguration -MustMeet -PlacementConfiguration <PlacementConfigurationSettings> [-DVDDriveRequirement] [-JobVariable <String> ] [-LoadBalancerRequirement] [-NetworkRequirement] [-PassthroughDiskRequirement] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-VMQueueAvailability] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetToOff
Set-SCPlacementConfiguration -Off -PlacementConfiguration <PlacementConfigurationSettings> [-DVDDriveRequirement] [-JobVariable <String> ] [-LoadBalancerRequirement] [-NetworkRequirement] [-PassthroughDiskRequirement] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-VMQueueAvailability] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetToShouldMeet
Set-SCPlacementConfiguration -PlacementConfiguration <PlacementConfigurationSettings> -ShouldMeet [-DVDDriveRequirement] [-JobVariable <String> ] [-LoadBalancerRequirement] [-NetworkRequirement] [-PassthroughDiskRequirement] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-VMQueueAvailability] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-SCPlacementConfiguration cmdlet sets the placement configuration settings for a host group. To update settings for a host group, that host group must not be inheriting its settings from a parent host group.

パラメーター

-DVDDriveRequirement

Indicates that the destination host must have the number of physical DVD drives required by a virtual machine for placement. If a specific DVD drive letter has been configured on the virtual machine, the host must have a DVD drive that uses that same drive letter.

-Favor

Indicates that the placement process will select a host even if the host does not meet all requirements; no warning message is displayed to the user.

-Inherit<Boolean>

Indicates whether settings are inherited from the parent host group.

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-LoadBalancerRequirement

Indicates that the destination host must have access to a load balancer for placement.

-MustMeet

Indicates that the placement process will not select a host if the host does not meet the requirements.

-NetworkRequirement

Indicates that the destination host must have virtual switches that connect to each of the logical networks required by a virtual machine for placement.

-Off

Indicates that a placement check is turned off, therefore placement will not consider that metric when determining whether the destination host meets placement metrics.

-PassthroughDiskRequirement

Indicates that a destination host must support passthrough disks for placement.

-PlacementConfiguration<PlacementConfigurationSettings>

Specifies a placement configuration object.

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-ShouldMeet

Indicates that the placement process will select a host even if the host does not meet all requirements; a warning message is displayed to the user.

-VMMServer<ServerConnection>

Specifies a VMM server object.

-VMQueueAvailability

Indicates that a destination host must support network optimizations for placement.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• PlacementConfiguration

例

Example 1: Set the placement settings which must be met by a host group

The first command gets the host group object named HostGroup01, and then stores the object in the $HostGroup variable.

The second command gets the placement configuration object for the host group stored in $HostGroup, and then stores the object in the $PlacementConfig variable.

The last command updates the settings for the placement configuration stored in $PlacementConfig.

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $PlacementConfig = Get-SCPlacementConfiguration -VMHostGroup $HostGroup
PS C:\> Set-SCPlacementConfiguration -PlacementConfiguration $PlacementConfig -MustMeet -ClusterReserveRequirement -HighAvailabilityRequirement -IPAddressAvailabilityRequirement

Example 2: Reset the placement settings for a host group to inherit from the parent host group

The first command gets the host group object named HostGroup01, and then stores the object in the $HostGroup variable.

The second command gets the placement configuration object for the host group stored in $HostGroup, and stores the object in the $PlacementConfig variable.

The last command sets the placement configuration stored in $PlacementConfig to inherit its placement settings from its parent host group.

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $PlacementConfig = Get-SCPlacementConfiguration -VMHostGroup $HostGroup
PS C:\> Set-SCPlacementConfiguration -PlacementConfiguration $PlacementConfig -Inherit $True

Example 3: Turn off placement settings for a host group

The first command gets the host group object named HostGroup01, and then stores the object in the $HostGroup variable.

The second command gets the placement configuration object for the host group stored in $HostGroup, and then stores the object in the $PlacementConfig variable.

The last command turns off the specified placement settings for the placement configuration stored in $PlacementConfig.

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $PlacementConfig = Get-SCPlacementConfiguration -VMHostGroup $HostGroup
PS C:\> Set-SCPlacementConfiguration -PlacementConfiguration $PlacementConfig -Off -ClusterReserveRequirement -HighAvailabilityRequirement -IPAddressAvailabilityRequirement

関連トピック

Get-SCPlacementConfiguration

Get-SCVMHostGroup