Get-CMAccessLicense

Gets license usage information.

Syntax

Get-CMAccessLicense
   [-License]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMAccessLicense
   [-Count]
   -LicenseName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMAccessLicense
   -LicenseName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

The Get-CMAccessLicense cmdlet gets license usage information for the servers and clients in the scope of Configuration Manager. This cmdlet returns a list of features able to be licensed and a list of unique users and devices per licensable feature.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get all licensable features for all servers and clients

PS XYZ:\> Get-CMAccessLicense -License

This command gets all licensable features for all servers and clients within the scope of Configuration Manager.

Example 2: Get the unique users, devices, and license-specific unique ID for a specified license

PS XYZ:\> Get-CMAccessLicense -LicenseName ConfigMgr_2012_EndPointClient

This command gets the unique users, devices, and license-specific IDs for the license named ConfigMgr_2012_EndPointClient.

Parameters

-Count

Indicates that the cmdlet returns a count of unique users and devices for the specified licensable feature.

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

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-License

Indicates that the cmdlet gets all licensable features for all of the servers and clients within the scope of Configuration Manager. You can specify the name of the license that is returned for the LicenseName parameter to obtain the unique users and devices for that specific license.

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

-LicenseName

Specifies the name of a licensable feature. If specified, the cmdlet gets only the unique users and devices for the specified license name. The acceptable values for this parameter are:

  • ConfigMgr_2012_CoreServer
  • ConfigMgr_2012_CoreClient
  • ConfigMgr_2012_EndpointClient
Type:String
Accepted values:ConfigMgr_2012_CoreServer, ConfigMgr_2012_CoreClient, ConfigMgr_2012_EndpointClient
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object