Share via

New-SCCapabilityProfile

Module:
VirtualMachineManager Module

Creates a capability profile.

Syntax

FromExisting 

New-SCCapabilityProfile
    -Name <String>
    -CapabilityProfile <CapabilityProfile>
    [-VMMServer <ServerConnection>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

FromValues 

New-SCCapabilityProfile
    -Name <String>
    -FabricCapabilityType <FabricCapabilityType>
    [-VMMServer <ServerConnection>]
    [-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 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

-CapabilityProfile

Specifies a capability profile object.

Parameter properties

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

Parameter sets

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

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

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

Specifies a description for the capability profile.

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

-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

Parameter properties

Type:FabricCapabilityType
Default value:None
Accepted values:HyperV, ESX
Supports wildcards:False
DontShow:False

Parameter sets

FromValues
Position:Named
Mandatory:True
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

(All)
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

-VMMServer

Specifies a VMM server object.

Parameter properties

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

Parameter sets

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

Outputs

CloudCapabilityProfile

This cmdlet returns a CloudCapabilityProfile object.