Share via

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