Get-SCOMAccessLicense

Gets information about licenses for Operations Manager and Windows.

Syntax

Get-SCOMAccessLicense
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAccessLicense
   [-ShowLicense]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseName

Specifies an array of license names.

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowLicense

Indicates that the cmdlet returns a list of available licenses that apply to this product.

Type:SwitchParameter
Aliases:List
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False