Test-SCCapabilityProfile
Validates the settings of a capability profile against a virtual machine, hardware profile, or virtual machine template.
Syntax
HardwareProfile
Test-SCCapabilityProfile
-HardwareProfile <HardwareProfile>
[-VMMServer <ServerConnection>]
[-CapabilityProfile <CapabilityProfile>]
[<CommonParameters>]
VM
Test-SCCapabilityProfile
-VM <VM>
[-VMMServer <ServerConnection>]
[-CapabilityProfile <CapabilityProfile>]
[<CommonParameters>]
Template
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.
Parameter properties
| Type: | CapabilityProfile |
| 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 |
-HardwareProfile
Specifies a hardware profile object.
Parameter properties
| Type: | HardwareProfile |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
HardwareProfile
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VM
Specifies a virtual machine object.
Parameter properties
| Type: | VM |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
VM
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| 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 |
-VMTemplate
Specifies a VMM template object used to create virtual machines.
Parameter properties
| Type: | Template |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Template |
Parameter sets
Template
| Position: | Named |
| Mandatory: | True |
| 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.