Get-CrmAccessLicense

Applies To: CRM 2015 on-prem

Get-CrmAccessLicense

Retrieves the server licensing and client access license (CAL) information for the Microsoft Dynamics CRM deployment.

Syntax

Parameter Set: DisplayLicenseInformation
Get-CrmAccessLicense [[-License]] [-Credential <PSCredential> ] [-Diag] [-DwsServerUrl <String> ] [-EndDate <DateTime> ] [-StartDate <DateTime> ] [-TabMethod <GetCrmAccessLicenseCmdlet+TabulationMethod> {Net | Unique} ] [-Timeout <Int32> ] [ <CommonParameters>]

Parameter Set: ProcessLicenseName
Get-CrmAccessLicense [-LicenseName] <String> {Dynamics CRM Server 2015 | Dynamics CRM Workgroup Server 2015 | Dynamics CRM 2015 Enterprise CAL | Dynamics CRM 2015 Professional CAL | Dynamics CRM 2015 Basic CAL | Dynamics CRM 2015 Essential CAL | Dynamics CRM 2015 Administrative CAL | Dynamics CRM 2015 Device Enterprise CAL | Dynamics CRM 2015 Device Professional CAL | Dynamics CRM 2015 Device Basic CAL | Dynamics CRM 2015 Device Essential CAL} [-Credential <PSCredential> ] [-Diag] [-DwsServerUrl <String> ] [-EndDate <DateTime> ] [-StartDate <DateTime> ] [-TabMethod <GetCrmAccessLicenseCmdlet+TabulationMethod> {Net | Unique} ] [-Timeout <Int32> ] [ <CommonParameters>]

Detailed Description

The Get-CrmAccessLicense cmdlet retrieves the server licensing and CAL information for the Microsoft Dynamics CRM deployment.

Parameters

-Credential<PSCredential>

Specifies the credentials used to log in to the Deployment web service.

-Diag

Turns on stack traces for error reports returned from Microsoft Dynamics CRM service calls. Enabling this emits a detailed error message, including a stack trace, when an error is encountered by the CRM PowerShell command.

-DwsServerUrl<String>

Identifies the location of the Deployment web service.This should be in the format: http://<serverurl> or https://<serverurl>, for example, http://contoso.

-EndDate<DateTime>

Filters data that is returned to data that is on or before this date.

-License

This parameter prints out the list of possible licenses.

-LicenseName<String>

Specifies the name of the license to report metrics for. The possible values are returned by a call to Get-CrmAccessLicenses –License.

-StartDate<DateTime>

Filters data that is returned to data that is on or after this date.

-TabMethod<GetCrmAccessLicenseCmdlet+TabulationMethod>

Describes the way that the set of data should be returned, either as unique records or counts.

-Timeout<Int32>

For internal use only.

<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.

Examples

-------------------------- EXAMPLE 1 --------------------------

This example returns a list of all license types and counts for all current system work in a table format.

PS C:\> Get-CrmAccessLicense | Format-Table

-------------------------- EXAMPLE 2 --------------------------

This example gets users for a license type within a specific date range.

PS C:\> Get-CrmAccessLicense –LicenseName “Dynamics CRM 2015 Basic CAL” –TabMethod Unique -StartDate “5/1/2015” –EndDate “6/1/2015”