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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EndDate<DateTime>
Filters data that is returned to data that is on or before this date.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-License
This parameter prints out the list of possible licenses.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-LicenseName<String>
Specifies the name of the license to report metrics for. The possible values are returned by a call to Get-CrmAccessLicenses –License.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-StartDate<DateTime>
Filters data that is returned to data that is on or after this date.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-TabMethod<GetCrmAccessLicenseCmdlet+TabulationMethod>
Describes the way that the set of data should be returned, either as unique records or counts.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Timeout<Int32>
For internal use only.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
<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”