Set-SCCapabilityProfile
Modifies the properties of a capability profile.
Syntax
Set-SCCapabilityProfile
-CapabilityProfile <CapabilityProfile>
-Name <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCCapabilityProfile
-CapabilityProfile <CapabilityProfile>
[-Description <String>]
[-CPUCountInitial <Int32>]
[-CPUCountMaximum <Int32>]
[-CPUCountMinimum <Int32>]
[-CPUCompatibilityModeValue <Boolean>]
[-CPUCompatibilityModeValueCanChange <Boolean>]
[-OSCompatibilityModeValue <Boolean>]
[-OSCompatibilityModeValueCanChange <Boolean>]
[-MemoryMBInitial <Int32>]
[-MemoryMBMaximum <Int32>]
[-MemoryMBMinimum <Int32>]
[-DynamicMemoryValue <Boolean>]
[-DynamicMemoryValueCanChange <Boolean>]
[-StartupMemoryMBInitial <Int32>]
[-StartupMemoryMBMaximum <Int32>]
[-StartupMemoryMBMinimum <Int32>]
[-MaximumMemoryMBInitial <Int32>]
[-MaximumMemoryMBMaximum <Int32>]
[-MaximumMemoryMBMinimum <Int32>]
[-TargetMemoryBufferPercentInitial <Int32>]
[-TargetMemoryBufferPercentMaximum <Int32>]
[-TargetMemoryBufferPercentMinimum <Int32>]
[-VirtualDVDDriveCountInitial <Int32>]
[-VirtualDVDDriveCountMaximum <Int32>]
[-VirtualDVDDriveCountMinimum <Int32>]
[-SharedDVDImageFileValue <Boolean>]
[-SharedDVDImageFileValueCanChange <Boolean>]
[-VirtualHardDiskCountInitial <Int32>]
[-VirtualHardDiskCountMaximum <Int32>]
[-VirtualHardDiskCountMinimum <Int32>]
[-DifferencingVirtualHardDiskValue <Boolean>]
[-DifferencingVirtualHardDiskValueCanChange <Boolean>]
[-DynamicVirtualHardDiskValue <Boolean>]
[-DynamicVirtualHardDiskValueCanChange <Boolean>]
[-FixedVirtualHardDiskValue <Boolean>]
[-FixedVirtualHardDiskValueCanChange <Boolean>]
[-VirtualHardDiskSizeMBInitial <Int32>]
[-VirtualHardDiskSizeMBMaximum <Int32>]
[-VirtualHardDiskSizeMBMinimum <Int32>]
[-NewDiskStorageClassificationValue <Guid>]
[-ExistDiskStorageClassificationValue <Guid>]
[-VirtualNetworkAdapterCountInitial <Int32>]
[-VirtualNetworkAdapterCountMaximum <Int32>]
[-VirtualNetworkAdapterCountMinimum <Int32>]
[-LogicalNetworkValue <Guid>]
[-NetworkOptimizationValue <Boolean>]
[-NetworkOptimizationValueCanChange <Boolean>]
[-VMHighlyAvailableValue <Boolean>]
[-VMHighlyAvailableValueCanChange <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] 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.
Examples
Example 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 256000The 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.
Parameters
-CapabilityProfile
Specifies a capability profile object.
| Type: | CapabilityProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-CPUCompatibilityModeValue
Indicates whether processor compatibility mode is enabled. When set to $True, Virtual Machine Manager (VMM) limits the processor features that a virtual machine can use in order to improve compatibility with a different processor version.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CPUCompatibilityModeValueCanChange
Indicates whether the value for CPU compatibility mode can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CPUCountInitial
Specifies the initial number of processors that a virtual machine will have when deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CPUCountMaximum
Specifies the maximum number of processors that a virtual machine deployed in a private cloud can have.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CPUCountMinimum
Specifies the minimum number of processors that a virtual machine deployed in a private cloud can have.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
States a description for the specified object.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DifferencingVirtualHardDiskValue
Indicates whether differencing disks are allowed.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DifferencingVirtualHardDiskValueCanChange
Indicates whether the value for differencing disks can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DynamicMemoryValue
Indicates whether dynamic memory is enabled.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DynamicMemoryValueCanChange
Indicates whether the value for dynamic memory can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DynamicVirtualHardDiskValue
Indicates whether dynamic virtual hard disks are allowed.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DynamicVirtualHardDiskValueCanChange
Indicates whether the value for dynamic virtual hard disks can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExistDiskStorageClassificationValue
Specifies a GUID.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FixedVirtualHardDiskValue
Indicates whether fixed virtual hard disks are allowed.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FixedVirtualHardDiskValueCanChange
Indicates whether the value for fixed virtual hard disks can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifies that job progress is tracked and stored in the variable named by this parameter.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalNetworkValue
Specifies a GUID.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumMemoryMBInitial
Specifies the initial maximum amount of memory, in megabytes (MB), allocated to a virtual machine when deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumMemoryMBMaximum
Specifies the highest amount of maximum memory, in megabytes (MB), that can be allocated to a virtual machine.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumMemoryMBMinimum
Specifies the lowest amount of maximum memory, in megabytes (MB), that can be allocated to a virtual machine.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MemoryMBInitial
Specifies the initial amount of memory, in megabytes (MB), allocated to a virtual machine when deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MemoryMBMaximum
Specifies the maximum amount of memory, in megabytes (MB), that can be allocated to a virtual machine.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MemoryMBMinimum
Specifies the minimum amount of memory, in megabytes (MB), that can be allocated to a virtual machine.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the name of a VMM object.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkOptimizationValue
Indicates whether network optimization is enabled.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkOptimizationValueCanChange
Indicates whether the value for network optimization can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewDiskStorageClassificationValue
Specifies a GUID.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OSCompatibilityModeValue
Indicates whether operating system compatibility mode is enabled.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OSCompatibilityModeValueCanChange
Indicates whether the value for operating system compatibility can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharedDVDImageFileValue
Indicates whether shared DVD image mode is enabled.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SharedDVDImageFileValueCanChange
Indicates whether the value for shared DVD image mode can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartupMemoryMBInitial
Specifies the initial amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartupMemoryMBMaximum
Specifies the maximum amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartupMemoryMBMinimum
Specifies the minimum amount of memory, in megabytes (MB), that is allocated to a virtual machine upon startup.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetMemoryBufferPercentInitial
Specifies the initial percentage of memory above a virtual machine's current memory allocation that the host should try to reserve as a buffer.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetMemoryBufferPercentMaximum
Specifies the maximum percentage of memory above a virtual machine's current memory allocation that the host should try to reserve as a buffer.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetMemoryBufferPercentMinimum
Specifies the minimum percentage of memory above a virtual machine's current memory allocation that the host should try to reserve as a buffer.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualDVDDriveCountInitial
Specifies the initial number of DVD drives attached to a virtual machine when deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualDVDDriveCountMaximum
Specifies the maximum number of DVD drives that can be attached to a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualDVDDriveCountMinimum
Specifies the minimum number of DVD drives that can be attached to a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDiskCountInitial
Specifies the initial number of virtual hard disks attached to a virtual machine when deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDiskCountMaximum
Specifies the maximum number of virtual hard disks that can be attached to a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDiskCountMinimum
Specifies the minimum number of virtual hard disks that can be attached to a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDiskSizeMBInitial
Specifies the initial hard disk size, in megabytes (MB), for a virtual machine when deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDiskSizeMBMaximum
Specifies the maximum virtual hard disk size, in megabytes (MB), allowed for a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualHardDiskSizeMBMinimum
Specifies the minimum virtual hard disk size, in megabytes (MB), allowed for a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetworkAdapterCountInitial
Specifies the initial number of virtual network adapters attached to a virtual machine when deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetworkAdapterCountMaximum
Specifies the maximum number of virtual network adapters that can be attached to a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetworkAdapterCountMinimum
Specifies the minimum number of virtual network adapters that can be attached to a virtual machine deployed in a private cloud.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHighlyAvailableValue
Indicates whether a deployed virtual machine will be highly available.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHighlyAvailableValueCanChange
Indicates whether the value indicating the high availability status of a virtual machine can be updated.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Notes
- Requires a VMM capability profile object, which can be retrieved by using the Get-SCCapabilityProfile cmdlet.