The New-SCCapabilityProfile cmdlet creates a capability profile object in System Center Virtual Machine Manager (VMM). A capability profile is used to specify the capabilities of a virtual machine on a supported hypervisor when the virtual machine is deployed to a private cloud.
For more information about New-SCCapabilityProfile, type: "Get-Help New-SCCapabilityProfile -online".
Parameters
Name
Required?
true
Accept Pipeline Input?
false
Position?
named
Specifies the name of a VMM object.
CapabilityProfile
Required?
false
Accept Pipeline Input?
false
Position?
named
Specifies a capability profile 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.
VMMServer
Required?
false
Accept Pipeline Input?
false
Position?
named
Specifies a VMM server object.
Name
Required?
true
Accept Pipeline Input?
false
Position?
named
Specifies the name of a VMM 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.
FabricCapabilityType
Required?
false
Accept Pipeline Input?
false
Position?
named
Specifies a fabric capability type. Fabric capability indicates the capabilities of the virtualization platform on which you will be deploying a virtual machie. VMM ensures that the settings in a capability profile are compatible with the selected fabric capability. Valid values are: HyperV, ESX, and Xen.
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.
VMMServer
Required?
false
Accept Pipeline Input?
false
Position?
named
Specifies a VMM server object.
Examples
1: Create a capability profile that is
compatible with Hyper-V hosts.
The first command creates a capability profile object named CapabilityProf01 that is compatible with Hyper-V hosts and stores the object in the $CapabilityProfile variable.
The second command displays information about the capability profile stored in $CapabilityProfile to the user.