Set-SCHostReserve

Set-SCHostReserve

Modifies the host reserve settings for a host group.

構文

Parameter Set: FromCPUEnabled
Set-SCHostReserve -CPU -Enabled <Boolean> -HostReserve <HostReserveSettings> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromCPUPlacementLevel
Set-SCHostReserve -CPU -HostReserve <HostReserveSettings> -PlacementLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromCPUStartOptimizationLevel
Set-SCHostReserve -CPU -HostReserve <HostReserveSettings> -StartOptimizationLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromCPUVMHostReserveLevel
Set-SCHostReserve -CPU -HostReserve <HostReserveSettings> -VMHostReserveLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskIOEnabled
Set-SCHostReserve -DiskIO -Enabled <Boolean> -HostReserve <HostReserveSettings> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskIOIOPS
Set-SCHostReserve -DiskIO -HostReserve <HostReserveSettings> -IOPS [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskIOPercent
Set-SCHostReserve -DiskIO -HostReserve <HostReserveSettings> -Percent [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskIOPlacementLevel
Set-SCHostReserve -DiskIO -HostReserve <HostReserveSettings> -PlacementLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskIOStartOptimizationLevel
Set-SCHostReserve -DiskIO -HostReserve <HostReserveSettings> -StartOptimizationLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskIOVMHostReserveLevel
Set-SCHostReserve -DiskIO -HostReserve <HostReserveSettings> -VMHostReserveLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskSpaceEnabled
Set-SCHostReserve -DiskSpace -Enabled <Boolean> -HostReserve <HostReserveSettings> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskSpaceGB
Set-SCHostReserve -DiskSpace -GB -HostReserve <HostReserveSettings> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskSpaceMB
Set-SCHostReserve -DiskSpace -HostReserve <HostReserveSettings> -MB [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskSpacePercent
Set-SCHostReserve -DiskSpace -HostReserve <HostReserveSettings> -Percent [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskSpacePlacementLevel
Set-SCHostReserve -DiskSpace -HostReserve <HostReserveSettings> -PlacementLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromDiskSpaceVMHostReserveLevel
Set-SCHostReserve -DiskSpace -HostReserve <HostReserveSettings> -VMHostReserveLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromMemoryEnabled
Set-SCHostReserve -Enabled <Boolean> -HostReserve <HostReserveSettings> -Memory [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromMemoryGB
Set-SCHostReserve -GB -HostReserve <HostReserveSettings> -Memory [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromMemoryMB
Set-SCHostReserve -HostReserve <HostReserveSettings> -MB -Memory [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromMemoryPercent
Set-SCHostReserve -HostReserve <HostReserveSettings> -Memory -Percent [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromMemoryPlacementLevel
Set-SCHostReserve -HostReserve <HostReserveSettings> -Memory -PlacementLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromMemoryStartOptimizationLevel
Set-SCHostReserve -HostReserve <HostReserveSettings> -Memory -StartOptimizationLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromMemoryVMHostReserveLevel
Set-SCHostReserve -HostReserve <HostReserveSettings> -Memory -VMHostReserveLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromNetworkEnabled
Set-SCHostReserve -Enabled <Boolean> -HostReserve <HostReserveSettings> -Network [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromNetworkMbps
Set-SCHostReserve -HostReserve <HostReserveSettings> -Mbps -Network [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromNetworkPercent
Set-SCHostReserve -HostReserve <HostReserveSettings> -Network -Percent [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromNetworkPlacementLevel
Set-SCHostReserve -HostReserve <HostReserveSettings> -Network -PlacementLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromNetworkStartOptimizationLevel
Set-SCHostReserve -HostReserve <HostReserveSettings> -Network -StartOptimizationLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromNetworkVMHostReserveLevel
Set-SCHostReserve -HostReserve <HostReserveSettings> -Network -VMHostReserveLevel <UInt64> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ToInherit
Set-SCHostReserve -HostReserve <HostReserveSettings> -Inherit <Boolean> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-SCHostReserve cmdlet modifies the host reserve settings for a host group. To modify the host reserve settings for a host group, that host group must not be inheriting its settings from a parent host group.

When you set the host reserve levels, the unit parameters, such as GB or Percent, dictate the units in which the other levels, such as StartOptimizationLevel and PlacementLevel, are expressed.

The values for VMHostReserveLevel, StartOptimizationLevel, and PlacementLevel must be represented in order. For example, the value for StartOptimizationLevel cannot be less than the value for VMHostReserveLevel, and the value for PlacementLevel cannot be less than the value for StartOptimizationLevel.

When the host has less than the specified amount for StartOptimizationLevel available, Dynamic Optimization will automatically try to rebalance the load.

A host will never be forced by Power Optimization to have less than the specified amount for PlacementLevel available because of another node being powered off.

パラメーター

-CPU

Specifies a host reserve CPU resource type.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-DiskIO

Specifies a host reserve Disk I/O resource type.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-DiskSpace

Specifies a host reserve disk space resource type.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Enabled<Boolean>

Enables an object when set to $True, or disables an object when set to $False. For example, if you want to upgrade software on a virtual machine template, you can disable the template object in the VMM library to temporarily prevent users from using that object.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-GB

Indicates that the unit for a host reserve resource is expressed in gigabytes (GB).

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-HostReserve<HostReserveSettings>

Specifies a host reserve settings object.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-Inherit<Boolean>

Indicates whether settings are inherited from the parent host group.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-IOPS

Indicates that the unit for a host reserve resource is expressed in disk input/output operations per second (IOPS).

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-JobVariable<String>

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

エイリアス

none

必須?

false

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-MB

Indicates that the unit for a host reserve resource is expressed in megabytes (MB).

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Mbps

Indicates that the unit for a host reserve resource is expressed in megabits per second (Mbps).

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Memory

Specifies a host reserve memory resource type.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Network

Specifies a host reserve Network I/O resource type.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Percent

Indicates that the unit for a host reserve resource is expressed in percent (%).

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-PlacementLevel<UInt64>

Specifies the host reserve level above which placement is acceptable.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-PROTipID<Guid]>

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

エイリアス

none

必須?

false

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-RunAsynchronously

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

エイリアス

none

必須?

false

位置は?

named

既定値

none

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-StartOptimizationLevel<UInt64>

Specifies the host reserve level at which dynamic optimization is started.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-VMHostReserveLevel<UInt64>

Specifies the host reserve level at which placement returns an error if starting a virtual machine would require dropping below this level.

エイリアス

none

必須?

true

位置は?

named

既定値

none

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

エイリアス

none

必須?

false

位置は?

named

既定値

none

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-Confirm

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

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

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

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

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

入力

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

出力

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

  • HostReserve

Example 1: Modify the CPU host reserve and placement settings for a specified 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 host reserve object for the host group stored in $HostGroup, and then stores the object in the $HostReserve variable.

The last command uses the pipeline operator to pass the host reserve stored in $HostReserve to the Set-SCHostReserve cmdlet. That cmdlet updates the host reserve and placement settings.

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostReserve = Get-SCHostReserve -VMHostGroup $HostGroup
PS C:\> $HostReserve | Set-SCHostReserve -CPU -PlacementLevel 75 -StartOptimizationLevel 80 -VMHostReserveLevel 90 

関連トピック

Get-SCHostReserve

Get-SCVMHostGroup