Get-SCOMAccessLicense
Gets information about licenses for Operations Manager and Windows.
Syntax
Empty (Default)
Get-SCOMAccessLicense
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromLicense
Get-SCOMAccessLicense
[-ShowLicense]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromLicenseName
Get-SCOMAccessLicense
[-LicenseName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
The Get-SCOMAccessLicense cmdlet gets a list of System Center - Operations Manager license types or a list of computers and their license information. Use this cmdlet as part of a central management system that correlates and deduplicates the license information with Access License data from other System Center products.
By default, this cmdlet uses the active persistent connection to a management group. Use the SCSession parameter to specify a different persistent connection. You can create a temporary connection to a management group by using the ComputerName and Credential parameters. For more information, type
Get-Help about_OpsMgr_Connections
.
Examples
Example 1: Get all licenses on the local computer
PS C:\>Get-SCOMAccessLicense
This command gets information about all licenses for System Center - Operations Manager and Windows for the local computer.
Example 2: Get all licenses for Operations Manager
PS C:\>Get-SCOMAccessLicense -LicenseName
This command gets all the licenses for System Center - Operations Manager for the local computer.
Example 3: Get licenses by using a name
PS C:\>Get-SCOMAccessLicense -LicenseName "System Center Operations Manager 2012 Management Server"
This command gets all licenses that have the name System Center Operations Manager 2012 Management Server.
Example 4: Get licenses by using a name
PS C:\>Get-SCOMAccessLicense -LicenseName "SML"
This command gets all licenses that have the name SML.
Parameters
-ComputerName
Specifies an array of names of computers. You can use NetBIOS names, IP addresses, or fully qualified domain names (FQDNs). To specify the local computer, type the computer name, localhost, or a dot (.).
The System Center Data Access service must be running on the computer. If you do not specify a computer, the cmdlet uses the computer for the current management group connection.
Parameter properties
Type: | String[] |
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 |
-Credential
Specifies a PSCredential object for the management group connection.
To obtain a PSCredential object, use the Get-Credential cmdlet.
For more information, type Get-Help Get-Credential
.
If you specify a computer in the ComputerName parameter, use an account that has access to that computer. The default is the current user.
Parameter properties
Type: | PSCredential |
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 |
-LicenseName
Specifies an array of license names.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
FromLicenseName
Position: | 1 |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | True |
Value from remaining arguments: | False |
-SCSession
Specifies an array of Connection objects. To obtain a Connection object, use the Get-SCManagementGroupConnection cmdlet.
A connection object represents a connection to a management server. The default is the current management group connection.
Parameter properties
Type: | Connection[] |
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 |
-ShowLicense
Indicates that the cmdlet returns a list of available licenses that apply to this product.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | List |
Parameter sets
FromLicense
Position: | 1 |
Mandatory: | True |
Value from pipeline: | False |
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.