Share via


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.