Test-SCCapabilityProfile

Test-SCCapabilityProfile

Validates the settings of a capability profile against a virtual machine, hardware profile, or virtual machine template.

Syntax

Parameter Set: HardwareProfile
Test-SCCapabilityProfile -HardwareProfile <HardwareProfile> [-CapabilityProfile <CapabilityProfile> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: Template
Test-SCCapabilityProfile -VMTemplate <Template> [-CapabilityProfile <CapabilityProfile> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: VM
Test-SCCapabilityProfile -VM <VM> [-CapabilityProfile <CapabilityProfile> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The Test-SCCapabilityProfile cmdlet validates the settings of a capability profile against the virtual machine, hardware profile, or virtual machine template to which the profile is attached.

Parameters

-CapabilityProfile<CapabilityProfile>

Specifies a capability profile object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-HardwareProfile<HardwareProfile>

Specifies a hardware profile object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VM<VM>

Specifies a virtual machine object.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

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

-VMTemplate<Template>

Specifies a VMM template object used to create virtual machines.

Aliases

Template

Required?

true

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.

Examples

Example 1: Validate a capability profile for a virtual machine in a private cloud

The first command gets the virtual machine object named CloudVM01, and then stores the object in the $VM variable.

The second command tests the settings of the capability profile attached to the virtual machine stored in $VM, and then stores the results in the $ProfileTest variable.

The last command displays any validation errors that occurred during testing.

PS C:\> $VM = Get-SCVirtualMachine -Name "CloudVM01"
PS C:\> $ProfileTest = Test-SCCapabilityProfile -VM $VM
PS C:\> $ProfileTest.ValidationErrors

Get-SCCapabilityProfile

New-SCCapabilityProfile

Remove-SCCapabilityProfile

Set-SCCapabilityProfile

Get-SCVirtualMachine