Set-SCCapabilityProfile

Modifies the properties of a capability profile.

Description

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".

For more information about Set-SCCapabilityProfile, type: "Get-Help Set-SCCapabilityProfile -online".

Parameters

CapabilityProfile

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a capability profile object.

Name

Required? true
Accept Pipeline Input? false
Position? named 
Specifies the name of a VMM object.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

CapabilityProfile

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a capability profile object.

CPUCompatibilityModeValue

Required? false
Accept Pipeline Input? false
Position? named 
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.

CPUCompatibilityModeValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for CPU compatibility mode can be updated.

CPUCountInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial number of processors that a virtual machine will have when deployed in a private cloud.

CPUCountMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum number of processors that a virtual machine deployed in a private cloud can have.

CPUCountMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum number of processors that a virtual machine deployed in a private cloud can have.

Description

Required? false
Accept Pipeline Input? false
Position? named 
States a description for the specified object.

DifferencingVirtualHardDiskValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether differencing disks are allowed.

DifferencingVirtualHardDiskValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for differencing disks can be updated.

DynamicMemoryValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether dynamic memory is enabled.

DynamicMemoryValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for dynamic memory can be updated.

DynamicVirtualHardDiskValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether dynamic virtual hard disks are allowed.

DynamicVirtualHardDiskValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for dynamic virtual hard disks can be updated.

ExistDiskStorageClassificationValue

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a GUID.

FixedVirtualHardDiskValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether fixed virtual hard disks are allowed.

FixedVirtualHardDiskValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for fixed virtual hard disks can be updated.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

LogicalNetworkValue

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a GUID.

MaximumMemoryMBInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial maximum amount of memory, in megabytes (MB), allocated to a virtual machine when deployed in a private cloud.

MaximumMemoryMBMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the highest amount of maximum memory, in megabytes (MB), that can be allocated to a virtual machine.

MaximumMemoryMBMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the lowest amount of maximum memory, in megabytes (MB), that can be allocated to a virtual machine.

MemoryMBInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial amount of memory, in megabytes (MB), allocated to a virtual machine when deployed in a private cloud.

MemoryMBMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum amount of memory, in megabytes (MB), that can be allocated to a virtual machine.

MemoryMBMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum amount of memory, in megabytes (MB), that can be allocated to a virtual machine.

NetworkOptimizationValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether network optimization is enabled.

NetworkOptimizationValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for network optimization can be updated.

NewDiskStorageClassificationValue

Required? false
Accept Pipeline Input? false
Position? named 
Specifies a GUID.

OSCompatibilityModeValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether operating system compatibility mode is enabled.

OSCompatibilityModeValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for operating system compatibility can be updated.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

SharedDVDImageFileValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether shared DVD image mode is enabled.

SharedDVDImageFileValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value for shared DVD image mode can be updated.

StartupMemoryMBInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.

StartupMemoryMBMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.

StartupMemoryMBMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.

TargetMemoryBufferPercentInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

TargetMemoryBufferPercentMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

TargetMemoryBufferPercentMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

VirtualDVDDriveCountInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial number of DVD drives attached to a virtual machine when deployed in a private cloud.

VirtualDVDDriveCountMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum number of DVD drives that can be attached to a virtual machine deployed in a private cloud.

VirtualDVDDriveCountMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum number of DVD drives that can be attached to a virtual machine deployed in a private cloud.

VirtualHardDiskCountInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial number of virtual hard disks attached to a virtual machine when deployed in a private cloud.

VirtualHardDiskCountMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum number of virtual hard disks that can be attached to a virtual machine deployed in a private cloud.

VirtualHardDiskCountMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum number of virtual hard disks that can be attached to a virtual machine deployed in a private cloud.

VirtualHardDiskSizeMBInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial hard disk size, in megabytes (MB), for a virtual machine when deployed in a private cloud.

VirtualHardDiskSizeMBMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum virtual hard disk size, in megabytes (MB), allowed for a virtual machine deployed in a private cloud.

VirtualHardDiskSizeMBMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum virtual hard disk size, in megabytes (MB), allowed for a virtual machine deployed in a private cloud.

VirtualNetworkAdapterCountInitial

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the initial number of virtual network adapters attached to a virtual machine when deployed in a private cloud.

VirtualNetworkAdapterCountMaximum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the maximum number of virtual network adapters that can be attached to a virtual machine deployed in a private cloud.

VirtualNetworkAdapterCountMinimum

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the minimum number of virtual network adapters that can be attached to a virtual machine deployed in a private cloud.

VMHighlyAvailableValue

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether a deployed virtual machine will be highly available.

VMHighlyAvailableValueCanChange

Required? false
Accept Pipeline Input? false
Position? named 
Indicates whether the value indicating the high availability status of a virtual machine can be updated.

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

Examples

1: Modify the default virtual hard disk settings of a capability profile 
PS C:\> $CapabilityProfile = Get-SCCapabilityProfile -Name "CapabilityProf01"
PS C:\> Set-SCCapabilityProfile -CapabilityProfile $CapabilityProfile -VirtualHardDiskCountMinimum 1 -VirtualHardDiskCountMaximum 8 -VirtualHardDiskSizeMBMaximum 256000

The first command gets the capability profile object named CapabilityProf01 and 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.

See Also