Get-SCCapabilityProfile
Get-SCCapabilityProfile
Gets a capability profile.
Syntax
Parameter Set: FromName
Get-SCCapabilityProfile [-Name <String> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]
Detailed Description
The Get-SCCapabilityProfile cmdlet gets one or more capability profile objects in Virtual Machine Manager (VMM).
Parameters
-Name<String>
Specifies the name of a VMM object.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-OnBehalfOfUser<System.String>
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-OnBehalfOfUserRole<Microsoft.SystemCenter.VirtualMachineManager.UserRole>
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
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 |
<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.
- CloudCapabilityProfile
Examples
Example 1: Get a capability profile by its name
This command gets the capability profile object named CapabilityProf01 and displays information about the object.
PS C:\> Get-SCCapabilityProfile -Name "CapabilityProf01"
Example Example 2: Get a capability profile by using the on behalf of parameters.
The first command gets the user role object named UR01, and then stores the object in the $UR variable.
The second command gets the capability profile object named CapabilityProf01 filtered by the user role stored in $UR and by the on behalf of user named user01@contoso.com. The cmdlet then displays information about the object.
PS C:\> $UR = Get-SCUserRole -Name "UR01"
PS C:\> Get-SCCapabilityProfile -Name "CapabilityProf01" -OnBehalfOfUserRole $UR -OnBehalfOfUser user01@contoso.com