New-SCCapabilityProfile

New-SCCapabilityProfile

Creates a capability profile.

Syntax

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

Parameter Set: FromValues
New-SCCapabilityProfile -FabricCapabilityType <FabricCapabilityType> {HyperV | ESX | Xen} -Name <String> [-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> ] [-FixedVirtualHardDiskValue <Boolean> ] [-FixedVirtualHardDiskValueCanChange <Boolean> ] [-JobVariable <String> ] [-LogicalNetworkValue <Guid> ] [-MaximumMemoryMBInitial <Int32> ] [-MaximumMemoryMBMaximum <Int32> ] [-MaximumMemoryMBMinimum <Int32> ] [-MemoryMBInitial <Int32> ] [-MemoryMBMaximum <Int32> ] [-MemoryMBMinimum <Int32> ] [-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> ] [-VirtualDVDDriveCountInitial <Int32> ] [-VirtualDVDDriveCountMaximum <Int32> ] [-VirtualDVDDriveCountMinimum <Int32> ] [-VirtualHardDiskCountInitial <Int32> ] [-VirtualHardDiskCountMaximum <Int32> ] [-VirtualHardDiskCountMinimum <Int32> ] [-VirtualHardDiskSizeMBInitial <Int32> ] [-VirtualHardDiskSizeMBMaximum <Int32> ] [-VirtualHardDiskSizeMBMinimum <Int32> ] [-VirtualNetworkAdapterCountInitial <Int32> ] [-VirtualNetworkAdapterCountMaximum <Int32> ] [-VirtualNetworkAdapterCountMinimum <Int32> ] [-VMHighlyAvailableValue <Boolean> ] [-VMHighlyAvailableValueCanChange <Boolean> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

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

Parameters

-CapabilityProfile<CapabilityProfile>

Specifies a capability profile object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CPUCompatibilityModeValue<Boolean>

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CPUCompatibilityModeValueCanChange<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CPUCountInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CPUCountMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CPUCountMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Description<String>

States a description for the specified object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DifferencingVirtualHardDiskValue<Boolean>

Indicates whether differencing disks are allowed.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DifferencingVirtualHardDiskValueCanChange<Boolean>

Indicates whether the value for differencing disks can be updated.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DynamicMemoryValue<Boolean>

Indicates whether dynamic memory is enabled.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DynamicMemoryValueCanChange<Boolean>

Indicates whether the value for dynamic memory can be updated.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DynamicVirtualHardDiskValue<Boolean>

Indicates whether dynamic virtual hard disks are allowed.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DynamicVirtualHardDiskValueCanChange<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ExistDiskStorageClassificationValue<Guid>

Specifies a GUID.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FabricCapabilityType<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. Valid values are: HyperV, ESX, and Xen.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FixedVirtualHardDiskValue<Boolean>

Indicates whether fixed virtual hard disks are allowed.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FixedVirtualHardDiskValueCanChange<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobVariable<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-LogicalNetworkValue<Guid>

Specifies a GUID.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaximumMemoryMBInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaximumMemoryMBMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MaximumMemoryMBMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MemoryMBInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MemoryMBMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-MemoryMBMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a VMM object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NetworkOptimizationValue<Boolean>

Indicates whether network optimization is enabled.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NetworkOptimizationValueCanChange<Boolean>

Indicates whether the value for network optimization can be updated.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NewDiskStorageClassificationValue<Guid>

Specifies a GUID.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OSCompatibilityModeValue<Boolean>

Indicates whether operating system compatibility mode is enabled.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OSCompatibilityModeValueCanChange<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

Aliases

none

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SharedDVDImageFileValue<Boolean>

Indicates whether shared DVD image mode is enabled.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SharedDVDImageFileValueCanChange<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-StartupMemoryMBInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-StartupMemoryMBMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-StartupMemoryMBMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TargetMemoryBufferPercentInitial<Int32>

Specifies the initial percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TargetMemoryBufferPercentMaximum<Int32>

Specifies the maximum percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-TargetMemoryBufferPercentMinimum<Int32>

Specifies the minimum percentage of memory above a virtual machine’s current memory allocation that the host should try to reserve as a buffer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualDVDDriveCountInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualDVDDriveCountMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualDVDDriveCountMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualHardDiskCountInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualHardDiskCountMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualHardDiskCountMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualHardDiskSizeMBInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualHardDiskSizeMBMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualHardDiskSizeMBMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualNetworkAdapterCountInitial<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualNetworkAdapterCountMaximum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VirtualNetworkAdapterCountMinimum<Int32>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMHighlyAvailableValue<Boolean>

Indicates whether a deployed virtual machine will be highly available.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMHighlyAvailableValueCanChange<Boolean>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • CloudCapabilityProfile

Examples

Example 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 then stores the object in the $CapabilityProfile variable.

The second command displays information about the capability profile stored in $CapabilityProfile.

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

Get-SCCapabilityProfile

Remove-SCCapabilityProfile

Set-SCCapabilityProfile

Test-SCCapabilityProfile