Test-SCCapabilityProfile

Reference

Module:: VirtualMachineManager

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

Syntax

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

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

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

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.

Examples

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

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

The first command gets the virtual machine object named CloudVM01 and 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 stores the results in the $ProfileTest variable.

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

Parameters

-CapabilityProfile

Specifies a capability profile object.

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

-HardwareProfile

Specifies a hardware profile object.

Type:	HardwareProfile
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

Specifies a virtual machine object.

Type:	VM
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

Specifies a VMM server object.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMTemplate

Specifies a VMM template object used to create virtual machines.

Type:	Template
Aliases:	Template
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False