New-SCCapabilityProfile

Creates a capability profile.

Syntax

New-SCCapabilityProfile [-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>] -FabricCapabilityType <FabricCapabilityType>
 [-FixedVirtualHardDiskValue <Boolean>] [-FixedVirtualHardDiskValueCanChange <Boolean>] [-JobVariable <String>]
 [-LogicalNetworkValue <Guid>] [-MaximumMemoryMBInitial <Int32>] [-MaximumMemoryMBMaximum <Int32>]
 [-MaximumMemoryMBMinimum <Int32>] [-MemoryMBInitial <Int32>] [-MemoryMBMaximum <Int32>]
 [-MemoryMBMinimum <Int32>] -Name <String> [-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>] [-VMHighlyAvailableValue <Boolean>]
 [-VMHighlyAvailableValueCanChange <Boolean>] [-VMMServer <ServerConnection>]
 [-VirtualDVDDriveCountInitial <Int32>] [-VirtualDVDDriveCountMaximum <Int32>]
 [-VirtualDVDDriveCountMinimum <Int32>] [-VirtualHardDiskCountInitial <Int32>]
 [-VirtualHardDiskCountMaximum <Int32>] [-VirtualHardDiskCountMinimum <Int32>]
 [-VirtualHardDiskSizeMBInitial <Int32>] [-VirtualHardDiskSizeMBMaximum <Int32>]
 [-VirtualHardDiskSizeMBMinimum <Int32>] [-VirtualNetworkAdapterCountInitial <Int32>]
 [-VirtualNetworkAdapterCountMaximum <Int32>] [-VirtualNetworkAdapterCountMinimum <Int32>] [<CommonParameters>]
New-SCCapabilityProfile -CapabilityProfile <CapabilityProfile> [-JobVariable <String>] -Name <String>
 [-PROTipID <Guid>] [-RunAsynchronously] [-VMMServer <ServerConnection>] [<CommonParameters>]

Description

The New-SCCapabilityProfile cmdlet creates a capability profile object in 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.

Examples

Example 1: Create a capability profile that is compatible with Hyper-V hosts

PS C:\> $CapabilityProfile = New-SCCapabilityProfile -Name "CapabilityProf01" -FabricCapabilityType "HyperV"
PS C:\> $CapabilityProfile

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.

Parameters

-CPUCompatibilityModeValue

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.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CPUCompatibilityModeValueCanChange

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

Type:Boolean
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CapabilityProfile

Specifies a capability profile object.

Type:CapabilityProfile
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for the capability profile.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DifferencingVirtualHardDiskValue

Indicates whether differencing disks are allowed.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DifferencingVirtualHardDiskValueCanChange

Indicates whether the value for differencing disks can be updated.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DynamicMemoryValue

Indicates whether dynamic memory is enabled.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DynamicMemoryValueCanChange

Indicates whether the value for dynamic memory can be updated.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DynamicVirtualHardDiskValue

Indicates whether dynamic virtual hard disks are allowed.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DynamicVirtualHardDiskValueCanChange

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

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ExistDiskStorageClassificationValue

Specifies a GUID.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FabricCapabilityType

Specifies a fabric capability type. Fabric capability indicates the capabilities of the virtualization platform on which you will be deploying a virtual machine. VMM ensures that the settings in a capability profile are compatible with the selected fabric capability. The acceptable values for this parameter are:

- HyperV

  • ESX
  • Xen

Type:FabricCapabilityType
Parameter Sets:HyperV, ESX
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FixedVirtualHardDiskValue

Indicates whether fixed virtual hard disks are allowed.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FixedVirtualHardDiskValueCanChange

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

Type:Boolean
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LogicalNetworkValue

Specifies a GUID.

Type:Guid
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies the name of a VMM object.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NetworkOptimizationValue

Indicates whether network optimization is enabled.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NetworkOptimizationValueCanChange

Indicates whether the value for network optimization can be updated.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewDiskStorageClassificationValue

Specifies a GUID.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OSCompatibilityModeValue

Indicates whether operating system compatibility mode is enabled.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OSCompatibilityModeValueCanChange

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

Type:Boolean
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SharedDVDImageFileValue

Indicates whether shared DVD image mode is enabled.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SharedDVDImageFileValueCanChange

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

Type:Boolean
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMHighlyAvailableValue

Indicates whether a deployed virtual machine will be highly available.

Type:Boolean
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

CloudCapabilityProfile

This cmdlet returns a **CloudCapabilityProfile** object.