Set-SCCapabilityProfile

Set-SCCapabilityProfile

Modifies the properties of a capability profile.

構文

Parameter Set: FromName
Set-SCCapabilityProfile -CapabilityProfile <CapabilityProfile> -Name <String> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [ <CommonParameters>]

Parameter Set: FromValues
Set-SCCapabilityProfile -CapabilityProfile <CapabilityProfile> [-CPUCompatibilityModeValue <Boolean> ] [-CPUCompatibilityModeValueCanChange <Boolean> ] [-CPUCountInitial <Int32> ] [-CPUCountMaximum <Int32> ] [-CPUCountMinimum <Int32> ] [-Description <String> ] [-DifferencingVirtualHardDiskValue <Boolean> ] [-DifferencingVirtualHardDiskValueCanChange <Boolean> ] [-DynamicMemoryValue <Boolean> ] [-DynamicMemoryValueCanChange <Boolean> ] [-DynamicVirtualHardDiskValue <Boolean> ] [-DynamicVirtualHardDiskValueCanChange <Boolean> ] [-ExistDiskStorageClassificationValue <Guid> ] [-FixedVirtualHardDiskValue <Boolean> ] [-FixedVirtualHardDiskValueCanChange <Boolean> ] [-JobVariable <String> ] [-LogicalNetworkValue <Guid> ] [-MaximumMemoryMBInitial <Int32> ] [-MaximumMemoryMBMaximum <Int32> ] [-MaximumMemoryMBMinimum <Int32> ] [-MemoryMBInitial <Int32> ] [-MemoryMBMaximum <Int32> ] [-MemoryMBMinimum <Int32> ] [-NetworkOptimizationValue <Boolean> ] [-NetworkOptimizationValueCanChange <Boolean> ] [-NewDiskStorageClassificationValue <Guid> ] [-OSCompatibilityModeValue <Boolean> ] [-OSCompatibilityModeValueCanChange <Boolean> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-SharedDVDImageFileValue <Boolean> ] [-SharedDVDImageFileValueCanChange <Boolean> ] [-StartupMemoryMBInitial <Int32> ] [-StartupMemoryMBMaximum <Int32> ] [-StartupMemoryMBMinimum <Int32> ] [-TargetMemoryBufferPercentInitial <Int32> ] [-TargetMemoryBufferPercentMaximum <Int32> ] [-TargetMemoryBufferPercentMinimum <Int32> ] [-VirtualDVDDriveCountInitial <Int32> ] [-VirtualDVDDriveCountMaximum <Int32> ] [-VirtualDVDDriveCountMinimum <Int32> ] [-VirtualHardDiskCountInitial <Int32> ] [-VirtualHardDiskCountMaximum <Int32> ] [-VirtualHardDiskCountMinimum <Int32> ] [-VirtualHardDiskSizeMBInitial <Int32> ] [-VirtualHardDiskSizeMBMaximum <Int32> ] [-VirtualHardDiskSizeMBMinimum <Int32> ] [-VirtualNetworkAdapterCountInitial <Int32> ] [-VirtualNetworkAdapterCountMaximum <Int32> ] [-VirtualNetworkAdapterCountMinimum <Int32> ] [-VMHighlyAvailableValue <Boolean> ] [-VMHighlyAvailableValueCanChange <Boolean> ] [ <CommonParameters>]

詳細説明

The Set-SCCapabilityProfile cmdlet modifies the properties of a capability profile object.

For information about creating a capability profile, type Get-Help New-SCCapabilityProfile -detailed.

パラメーター

-CapabilityProfile<CapabilityProfile>

Specifies a capability profile object.

エイリアス

none

必須?

true

位置は?

named

既定値

none

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

True (ByValue)

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

false

-CPUCompatibilityModeValue<Boolean>

Indicates whether processor compatibility mode is enabled. When set to $True, VMM limits the processor features that a virtual machine can use in order to improve compatibility with a different processor version.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-CPUCompatibilityModeValueCanChange<Boolean>

Indicates whether the value for CPU compatibility mode can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-CPUCountInitial<Int32>

Specifies the initial number of processors that a virtual machine will have when deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-CPUCountMaximum<Int32>

Specifies the maximum number of processors that a virtual machine deployed in a private cloud can have.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-CPUCountMinimum<Int32>

Specifies the minimum number of processors that a virtual machine deployed in a private cloud can have.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-Description<String>

States a description for the specified object.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-DifferencingVirtualHardDiskValue<Boolean>

Indicates whether differencing disks are allowed.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-DifferencingVirtualHardDiskValueCanChange<Boolean>

Indicates whether the value for differencing disks can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-DynamicMemoryValue<Boolean>

Indicates whether dynamic memory is enabled.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-DynamicMemoryValueCanChange<Boolean>

Indicates whether the value for dynamic memory can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-DynamicVirtualHardDiskValue<Boolean>

Indicates whether dynamic virtual hard disks are allowed.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-DynamicVirtualHardDiskValueCanChange<Boolean>

Indicates whether the value for dynamic virtual hard disks can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-ExistDiskStorageClassificationValue<Guid>

Specifies a GUID.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-FixedVirtualHardDiskValue<Boolean>

Indicates whether fixed virtual hard disks are allowed.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-FixedVirtualHardDiskValueCanChange<Boolean>

Indicates whether the value for fixed virtual hard disks can be updated.

エイリアス

none

必須?

false

位置は?

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

-LogicalNetworkValue<Guid>

Specifies a GUID.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-MaximumMemoryMBInitial<Int32>

Specifies the initial maximum amount of memory, in megabytes (MB), allocated to a virtual machine when deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-MaximumMemoryMBMaximum<Int32>

Specifies the highest amount of maximum memory, in megabytes (MB), that can be allocated to a virtual machine.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-MaximumMemoryMBMinimum<Int32>

Specifies the lowest amount of maximum memory, in megabytes (MB), that can be allocated to a virtual machine.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-MemoryMBInitial<Int32>

Specifies the initial amount of memory, in megabytes (MB), allocated to a virtual machine when deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-MemoryMBMaximum<Int32>

Specifies the maximum amount of memory, in megabytes (MB), that can be allocated to a virtual machine.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-MemoryMBMinimum<Int32>

Specifies the minimum amount of memory, in megabytes (MB), that can be allocated to a virtual machine.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-Name<String>

Specifies the name of a VMM object.

エイリアス

none

必須?

true

位置は?

named

既定値

none

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

false

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

false

-NetworkOptimizationValue<Boolean>

Indicates whether network optimization is enabled.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-NetworkOptimizationValueCanChange<Boolean>

Indicates whether the value for network optimization can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-NewDiskStorageClassificationValue<Guid>

Specifies a GUID.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-OSCompatibilityModeValue<Boolean>

Indicates whether operating system compatibility mode is enabled.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-OSCompatibilityModeValueCanChange<Boolean>

Indicates whether the value for operating system compatibility can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

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

-SharedDVDImageFileValue<Boolean>

Indicates whether shared DVD image mode is enabled.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-SharedDVDImageFileValueCanChange<Boolean>

Indicates whether the value for shared DVD image mode can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-StartupMemoryMBInitial<Int32>

Specifies the initial amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-StartupMemoryMBMaximum<Int32>

Specifies the maximum amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-StartupMemoryMBMinimum<Int32>

Specifies the minimum amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-TargetMemoryBufferPercentInitial<Int32>

Specifies the initial percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-TargetMemoryBufferPercentMaximum<Int32>

Specifies the maximum percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-TargetMemoryBufferPercentMinimum<Int32>

Specifies the minimum percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualDVDDriveCountInitial<Int32>

Specifies the initial number of DVD drives attached to a virtual machine when deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualDVDDriveCountMaximum<Int32>

Specifies the maximum number of DVD drives that can be attached to a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualDVDDriveCountMinimum<Int32>

Specifies the minimum number of DVD drives that can be attached to a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualHardDiskCountInitial<Int32>

Specifies the initial number of virtual hard disks attached to a virtual machine when deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualHardDiskCountMaximum<Int32>

Specifies the maximum number of virtual hard disks that can be attached to a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualHardDiskCountMinimum<Int32>

Specifies the minimum number of virtual hard disks that can be attached to a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualHardDiskSizeMBInitial<Int32>

Specifies the initial hard disk size, in megabytes (MB), for a virtual machine when deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualHardDiskSizeMBMaximum<Int32>

Specifies the maximum virtual hard disk size, in megabytes (MB), allowed for a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualHardDiskSizeMBMinimum<Int32>

Specifies the minimum virtual hard disk size, in megabytes (MB), allowed for a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualNetworkAdapterCountInitial<Int32>

Specifies the initial number of virtual network adapters attached to a virtual machine when deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualNetworkAdapterCountMaximum<Int32>

Specifies the maximum number of virtual network adapters that can be attached to a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VirtualNetworkAdapterCountMinimum<Int32>

Specifies the minimum number of virtual network adapters that can be attached to a virtual machine deployed in a private cloud.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VMHighlyAvailableValue<Boolean>

Indicates whether a deployed virtual machine will be highly available.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

-VMHighlyAvailableValueCanChange<Boolean>

Indicates whether the value indicating the high availability status of a virtual machine can be updated.

エイリアス

none

必須?

false

位置は?

named

既定値

none

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

false

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

false

<CommonParameters>

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

入力

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

出力

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

  • This cmdlet requires a VMM capability profile object, which can be retrieved by using the Get-SCCapabilityProfile cmdlet.

Example 1: Modify the default virtual hard disk settings of a capability profile

The first command gets the capability profile object named CapabilityProf01, and then stores the object in the $CapabilityProfile variable.

The second command sets the virtual hard disk minimum to 1, the virtual hard disk maximum to 8, and the maximum virtual hard disk size to 25600 MB (250 GB) for the capability profile stored in $CapabilityProfile.

PS C:\> $CapabilityProfile = Get-SCCapabilityProfile -Name "CapabilityProf01"
PS C:\> Set-SCCapabilityProfile -CapabilityProfile $CapabilityProfile -VirtualHardDiskCountMinimum 1 -VirtualHardDiskCountMaximum 8 -VirtualHardDiskSizeMBMaximum 256000

関連トピック

Get-SCCapabilityProfile

New-SCCapabilityProfile

Remove-SCCapabilityProfile

Test-SCCapabilityProfile