Share via

Set-SCCapabilityProfile

Module:
VirtualMachineManager Module

Modifies the properties of a capability profile.

Syntax

FromName 

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

FromValues 

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

Parameters

-CapabilityProfile

Specifies a capability profile object.

Parameter properties

Type:CapabilityProfile
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CPUCompatibilityModeValueCanChange

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CPUCountInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CPUCountMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CPUCountMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

States a description for the specified object.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DifferencingVirtualHardDiskValue

Indicates whether differencing disks are allowed.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DifferencingVirtualHardDiskValueCanChange

Indicates whether the value for differencing disks can be updated.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DynamicMemoryValue

Indicates whether dynamic memory is enabled.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DynamicMemoryValueCanChange

Indicates whether the value for dynamic memory can be updated.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DynamicVirtualHardDiskValue

Indicates whether dynamic virtual hard disks are allowed.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DynamicVirtualHardDiskValueCanChange

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ExistDiskStorageClassificationValue

Specifies a GUID.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FixedVirtualHardDiskValue

Indicates whether fixed virtual hard disks are allowed.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FixedVirtualHardDiskValueCanChange

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JobVariable

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LogicalNetworkValue

Specifies a GUID.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MaximumMemoryMBInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MaximumMemoryMBMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MaximumMemoryMBMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MemoryMBInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MemoryMBMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MemoryMBMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of a VMM object.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NetworkOptimizationValue

Indicates whether network optimization is enabled.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NetworkOptimizationValueCanChange

Indicates whether the value for network optimization can be updated.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NewDiskStorageClassificationValue

Specifies a GUID.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OSCompatibilityModeValue

Indicates whether operating system compatibility mode is enabled.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OSCompatibilityModeValueCanChange

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RunAsynchronously

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SharedDVDImageFileValue

Indicates whether shared DVD image mode is enabled.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SharedDVDImageFileValueCanChange

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StartupMemoryMBInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StartupMemoryMBMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StartupMemoryMBMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualDVDDriveCountInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualDVDDriveCountMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualDVDDriveCountMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualHardDiskCountInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualHardDiskCountMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualHardDiskCountMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualHardDiskSizeMBInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualHardDiskSizeMBMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualHardDiskSizeMBMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualNetworkAdapterCountInitial

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualNetworkAdapterCountMaximum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualNetworkAdapterCountMinimum

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

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VMHighlyAvailableValue

Indicates whether a deployed virtual machine will be highly available.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VMHighlyAvailableValueCanChange

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

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Notes

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