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