pac licensing

(Preview) Manage licensing, entitlements, capacity, billing policies, and allocations.

Commands

Command	Description
pac licensing add-billing-policy-environment	(Preview) Link billing policy ID with environments.
pac licensing create-billing-policy	(Preview) Creates the billing policy at tenant level.
pac licensing create-isv-contract	(Preview) Create an ISV contract.
pac licensing delete-billing-policy	(Preview) Delete billing policy.
pac licensing delete-isv-contract	(Preview) Delete an ISV contract.
pac licensing get-all-resource-thresholds	(Preview) Get all resource thresholds for the specified entitlement.
pac licensing get-allocations-availability-v2	(Preview) Get the entitlements available to be allocated for the scope.
pac licensing get-allocations-by-environment	(Preview) Get currency allocations and enforcement rules for an environment.
pac licensing get-billing-policy	(Preview) Get the billing policy at tenant level by policy ID.
pac licensing get-billing-policy-environment	(Preview) Get the environment linked to the billing policy.
pac licensing get-currency-allocation-by-environment	(Preview) Get currency allocations for the environment.
pac licensing get-entitlement	(Preview) Get the entitlement details for the tenant.
pac licensing get-environment-billing-policy	(Preview) Get the linked billing policy details for an environment.
pac licensing get-environment-resources	(Preview) Get environment resource entitlement snapshots for an entitlement.
pac licensing get-fin-ops-license-summary-v2	(Preview) Get FinOps license summary (V2) for the tenant.
pac licensing get-isv-contract	(Preview) Get an ISV contract by its identifier (ID).
pac licensing get-many-entitlements-reserved-v2	(Preview) Get the reserved entitlements for the scope.
pac licensing get-many-environment-entitlements	(Preview) Get the entitlements for the tenant by environment.
pac licensing get-storage-warning-by-category	(Preview) Storage warning thresholds filtered by category.
pac licensing get-storage-warning-by-category-and-entity	(Preview) Storage warning thresholds filtered by category and storage entity name.
pac licensing get-tenant-capacity-details	(Preview) Get the tenant capacity details for the tenant.
pac licensing get-tenant-license-trends	(Preview) Get the license trends for the tenant for the specified entitlement.
pac licensing get-tenant-resource-consumption-by-user	(Preview) Get resource consumption by entitlement and user ID.
pac licensing get-tenant-resources-across-environments	(Preview) Get tenant resources for an entitlement across all environments.
pac licensing get-tenant-user-consumption-by-resource	(Preview) Get tenant user consumption by entitlement and resource ID.
pac licensing get-tenant-users	(Preview) Get the list of tenant users entitlement snapshot for the specified entitlement.
pac licensing get-user-per-flow-capacity-source	(Preview) Get user per flow capacity source data with pagination and filtering options.
pac licensing get-user-per-flow-capacity-source-flow-context-summary	(Preview) Get flow context summary for user per flow capacity source.
pac licensing get-user-per-flow-capacity-source-flow-context-summary-for-user-id	(Preview) Get flow context summary for a specific user's per flow capacity source.
pac licensing get-user-per-flow-capacity-source-tenant-context-summary	(Preview) Get tenant context summary for user per flow capacity source.
pac licensing get-user-per-flow-capacity-source-user-context-summary	(Preview) Get the user per flow capacity source user context summary.
pac licensing get-user-per-flow-capacity-source-user-context-summary-for-user-id	(Preview) Get user context summary for a specific user's per flow capacity source.
pac licensing list-allocations-by-environment	(Preview) Get currency allocations and enforcement rules for all environments.
pac licensing list-billing-policies	(Preview) Get the list of billing policies for the tenant.
pac licensing list-billing-policy-environments	(Preview) Get the list of environments linked to the billing policy.
pac licensing list-currency-reports	(Preview) Get the currency report for the tenant.
pac licensing list-isv-contracts	(Preview) Get the list of ISV contracts for the tenant.
pac licensing list-storage-warnings	(Preview) Storage warning thresholds.
pac licensing patch-currency-allocation-by-environment	(Preview) Allocate and deallocate the currencies for the environment.
pac licensing put-allocations-v2	(Preview) Set the allocations for the scope.
pac licensing refresh-provisioning-status	(Preview) Refresh the billing policy provisioning status.
pac licensing remove-billing-policy-environment	(Preview) Unlink billing policy ID from environments.
pac licensing retrieve-temporary-currency-entitlement-count	(Preview) Get the temporary currency count and limit for the month by type.
pac licensing update-allocations-by-environment	(Preview) Update currency allocations and enforcement rules for an environment.
pac licensing update-billing-policy	(Preview) Updates the billing policy at tenant level.
pac licensing update-isv-contract	(Preview) Update an ISV contract.
pac licensing upsert-resource-threshold	(Preview) Create or update the resource threshold for an environment resource.

pac licensing add-billing-policy-environment

(Preview) Link billing policy ID with environments.

Required Parameters for licensing add-billing-policy-environment

--billing-policy-id

The billing policy ID.

Optional Parameters for licensing add-billing-policy-environment

--environment-ids

Provide the value as a JSON array.

pac licensing create-billing-policy

(Preview) Creates the billing policy at tenant level.

Optional Parameters for licensing create-billing-policy

--billing-instrument-id

ID of the billing instrument for the new billing policy.

--billing-instrument-resource-group

The resource group within the tenant subscription.

--billing-instrument-subscription-id

The tenant subscription Id.

--location

Location for the tenant-level billing policy.

--name

Name of the tenant-level billing policy to create.

--status

The desired ISV contract status.

Use one of these values:

• Enabled
• Disabled

pac licensing create-isv-contract

(Preview) Create an ISV contract.

Required Parameters for licensing create-isv-contract

--geo

Resource location for billing account creation. Immutable.

--name

Name of the ISV contract to create.

--status

The desired ISV contract status.

Use one of these values:

• Enabled
• Disabled

Optional Parameters for licensing create-isv-contract

--billing-instrument-id

ID of the billing instrument for the new ISV contract.

--billing-instrument-resource-group

The resource group within the tenant subscription.

--billing-instrument-subscription-id

The tenant subscription Id.

--conditions-api-filter

The Power Platform connector filter. Provide the value as a JSON object.

--consumer-tenant-id

The ID of the customer tenant.

--power-automate-policy-cloud-flow-runs-pay-as-you-go-state

Pay-as-you-go state for cloud flow runs under the new ISV contract.

Use one of these values:

• Enabled
• Disabled

--power-automate-policy-desktop-flow-attended-runs-pay-as-you-go-state

Pay-as-you-go state for attended desktop flow runs under the new ISV contract.

Use one of these values:

• Enabled
• Disabled

--power-automate-policy-desktop-flow-unattended-runs-pay-as-you-go-state

Pay-as-you-go state for unattended desktop flow runs under the new ISV contract.

Use one of these values:

• Enabled
• Disabled

pac licensing delete-billing-policy

(Preview) Delete billing policy.

Required Parameters for licensing delete-billing-policy

--billing-policy-id

The billing policy ID.

pac licensing delete-isv-contract

(Preview) Delete an ISV contract.

Required Parameters for licensing delete-isv-contract

--isv-contract-id

The ISV contract ID.

pac licensing get-all-resource-thresholds

(Preview) Get all resource thresholds for the specified entitlement.

Required Parameters for licensing get-all-resource-thresholds

--entitlement-id

The entitlement ID.

pac licensing get-allocations-availability-v2

(Preview) Get the entitlements available to be allocated for the scope.

Optional Parameters for licensing get-allocations-availability-v2

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--filter

OData filter expression.

pac licensing get-allocations-by-environment

(Preview) Get currency allocations and enforcement rules for an environment.

Optional Parameters for licensing get-allocations-by-environment

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

pac licensing get-billing-policy

(Preview) Get the billing policy at tenant level by policy ID.

Required Parameters for licensing get-billing-policy

--billing-policy-id

The billing policy ID.

pac licensing get-billing-policy-environment

(Preview) Get the environment linked to the billing policy.

Required Parameters for licensing get-billing-policy-environment

--billing-policy-id

The billing policy ID.

Optional Parameters for licensing get-billing-policy-environment

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

pac licensing get-currency-allocation-by-environment

(Preview) Get currency allocations for the environment.

Optional Parameters for licensing get-currency-allocation-by-environment

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

pac licensing get-entitlement

(Preview) Get the entitlement details for the tenant.

Required Parameters for licensing get-entitlement

--entitlement-id

The entitlement ID.

pac licensing get-environment-billing-policy

(Preview) Get the linked billing policy details for an environment.

Optional Parameters for licensing get-environment-billing-policy

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

pac licensing get-environment-resources

(Preview) Get environment resource entitlement snapshots for an entitlement.

Required Parameters for licensing get-environment-resources

--entitlement-id

The entitlement ID.

--from-date

The start date (inclusive) of the query range.

--to-date

The end date (inclusive) of the query range.

Optional Parameters for licensing get-environment-resources

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--continuation-token

Continuation token for pagination.

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

--include-fields

Comma separated additional fields to include in the response.

--orderby-consumed

Order by consumed date time if specified.

--search-request

Search request for filtering the resources.

pac licensing get-fin-ops-license-summary-v2

(Preview) Get FinOps license summary (V2) for the tenant.

pac licensing get-isv-contract

(Preview) Get an ISV contract by its identifier (ID).

Required Parameters for licensing get-isv-contract

--isv-contract-id

The ISV contract ID.

pac licensing get-many-entitlements-reserved-v2

(Preview) Get the reserved entitlements for the scope.

Optional Parameters for licensing get-many-entitlements-reserved-v2

--filter

OData filter expression.

pac licensing get-many-environment-entitlements

(Preview) Get the entitlements for the tenant by environment.

Optional Parameters for licensing get-many-environment-entitlements

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

--filter

OData filter expression.

pac licensing get-storage-warning-by-category

(Preview) Storage warning thresholds filtered by category.

Required Parameters for licensing get-storage-warning-by-category

--storage-category

The storage category value.

pac licensing get-storage-warning-by-category-and-entity

(Preview) Storage warning thresholds filtered by category and storage entity name.

Required Parameters for licensing get-storage-warning-by-category-and-entity

--entity-name

The name of the entity.

--storage-category

The storage category value.

pac licensing get-tenant-capacity-details

(Preview) Get the tenant capacity details for the tenant.

Optional Parameters for licensing get-tenant-capacity-details

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

pac licensing get-tenant-license-trends

(Preview) Get the license trends for the tenant for the specified entitlement.

Required Parameters for licensing get-tenant-license-trends

--entitlement-id

The entitlement ID.

--from-date

The start date (inclusive) of the query range.

--to-date

The end date (inclusive) of the query range.

Optional Parameters for licensing get-tenant-license-trends

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--filter

OData filter expression.

--top

The maximum number of records to return.

pac licensing get-tenant-resource-consumption-by-user

(Preview) Get resource consumption by entitlement and user ID.

Required Parameters for licensing get-tenant-resource-consumption-by-user

--entitlement-id

The entitlement ID.

--from-date

The start date (inclusive) of the query range.

--to-date

The end date (inclusive) of the query range.

--user-id

The user ID.

Optional Parameters for licensing get-tenant-resource-consumption-by-user

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--continuation-token

Continuation token for pagination.

--page-size

The page size for pagination.

--search-request

Search request for filtering.

pac licensing get-tenant-resources-across-environments

(Preview) Get tenant resources for an entitlement across all environments.

Required Parameters for licensing get-tenant-resources-across-environments

--entitlement-id

The entitlement ID.

--from-date

The start date (inclusive) of the query range.

--to-date

The end date (inclusive) of the query range.

Optional Parameters for licensing get-tenant-resources-across-environments

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--continuation-token

Opaque continuation token returned by the previous page, or null for the first page.

--page-size

Maximum number of environments to fan out to per page.

pac licensing get-tenant-user-consumption-by-resource

(Preview) Get tenant user consumption by entitlement and resource ID.

Required Parameters for licensing get-tenant-user-consumption-by-resource

--entitlement-id

The entitlement ID.

--from-date

The start date (inclusive) of the query range.

--resource-id

The resource ID.

--to-date

The end date (inclusive) of the query range.

Optional Parameters for licensing get-tenant-user-consumption-by-resource

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--continuation-token

Continuation token for pagination.

--page-size

The page size for pagination.

--search-request

Search request for filtering.

pac licensing get-tenant-users

(Preview) Get the list of tenant users entitlement snapshot for the specified entitlement.

Required Parameters for licensing get-tenant-users

--entitlement-id

The entitlement ID.

--from-date

The start date (inclusive) of the query range.

--to-date

The end date (inclusive) of the query range.

Optional Parameters for licensing get-tenant-users

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--continuation-token

Continuation token for pagination.

--orderby-consumed

Order by consumed field.

--page-size

The page size for pagination.

--search-request

Search request for filtering the users.

pac licensing get-user-per-flow-capacity-source

(Preview) Get user per flow capacity source data with pagination and filtering options.

Required Parameters for licensing get-user-per-flow-capacity-source

--start-date

The start date for the query range.

Optional Parameters for licensing get-user-per-flow-capacity-source

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--end-date

The end date for the query range. Defaults to current UTC time if not provided.

--environment-id

Filter by environment identifier.

--flow-context

Filter by flow context.

--flow-license-categorization

Filter by flow license categorization.

--page-number

The page number for pagination.

--page-size

The page size for pagination.

--resource-id

Filter by resource identifier.

--user-id

Filter by user identifier.

pac licensing get-user-per-flow-capacity-source-flow-context-summary

(Preview) Get flow context summary for user per flow capacity source.

Required Parameters for licensing get-user-per-flow-capacity-source-flow-context-summary

--start-date

The start date for the query range.

Optional Parameters for licensing get-user-per-flow-capacity-source-flow-context-summary

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--end-date

The end date for the query range. Defaults to current UTC time if not provided.

--environment-id

Filter by environment identifier.

--page-number

The page number for pagination.

--page-size

The page size for pagination.

pac licensing get-user-per-flow-capacity-source-flow-context-summary-for-user-id

(Preview) Get flow context summary for a specific user's per flow capacity source.

Required Parameters for licensing get-user-per-flow-capacity-source-flow-context-summary-for-user-id

--start-date

The start date for the query range.

--user-id

The user identifier.

Optional Parameters for licensing get-user-per-flow-capacity-source-flow-context-summary-for-user-id

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--end-date

The end date for the query range. Defaults to current UTC time if not provided.

--environment-id

Filter by environment identifier.

--page-number

The page number for pagination.

--page-size

The page size for pagination.

pac licensing get-user-per-flow-capacity-source-tenant-context-summary

(Preview) Get tenant context summary for user per flow capacity source.

Required Parameters for licensing get-user-per-flow-capacity-source-tenant-context-summary

--start-date

The start date for the query range.

Optional Parameters for licensing get-user-per-flow-capacity-source-tenant-context-summary

--end-date

The end date for the query range. Defaults to current UTC time if not provided.

--environment-id

Filter by environment identifier.

pac licensing get-user-per-flow-capacity-source-user-context-summary

(Preview) Get the user per flow capacity source user context summary.

Required Parameters for licensing get-user-per-flow-capacity-source-user-context-summary

--start-date

The start date for the query range.

Optional Parameters for licensing get-user-per-flow-capacity-source-user-context-summary

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--end-date

The end date for the query range. Defaults to current UTC time if not provided.

--environment-id

Filter by environment identifier.

--page-number

The page number for pagination.

--page-size

The page size for pagination.

pac licensing get-user-per-flow-capacity-source-user-context-summary-for-user-id

(Preview) Get user context summary for a specific user's per flow capacity source.

Required Parameters for licensing get-user-per-flow-capacity-source-user-context-summary-for-user-id

--start-date

The start date for the query range.

--user-id

The user identifier.

Optional Parameters for licensing get-user-per-flow-capacity-source-user-context-summary-for-user-id

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--end-date

The end date for the query range. Defaults to current UTC time if not provided.

--environment-id

Filter by environment identifier.

--page-number

The page number for pagination.

--page-size

The page size for pagination.

pac licensing list-allocations-by-environment

(Preview) Get currency allocations and enforcement rules for all environments.

pac licensing list-billing-policies

(Preview) Get the list of billing policies for the tenant.

Optional Parameters for licensing list-billing-policies

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--top

The ISV contract ID.

pac licensing list-billing-policy-environments

(Preview) Get the list of environments linked to the billing policy.

Required Parameters for licensing list-billing-policy-environments

--billing-policy-id

The billing policy ID.

Optional Parameters for licensing list-billing-policy-environments

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

pac licensing list-currency-reports

(Preview) Get the currency report for the tenant.

Optional Parameters for licensing list-currency-reports

--include-allocations

Flag indicating to include allocations.

--include-consumptions

Flag indicating to include consumptions.

pac licensing list-isv-contracts

(Preview) Get the list of ISV contracts for the tenant.

Optional Parameters for licensing list-isv-contracts

--columns

Comma-separated list of response properties to include in table output. Use --json for the complete response.

--top

Top limit of results.

pac licensing list-storage-warnings

(Preview) Storage warning thresholds.

pac licensing patch-currency-allocation-by-environment

(Preview) Allocate and deallocate the currencies for the environment.

Optional Parameters for licensing patch-currency-allocation-by-environment

--currency-allocations

Specify the request body with environment ID and currency details. Provide the value as a JSON array.

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

pac licensing put-allocations-v2

(Preview) Set the allocations for the scope.

Optional Parameters for licensing put-allocations-v2

--allocated-entitlements

Allocated entitlements. Provide the value as a JSON array.

--scope-environment-group-id

Environment group ID that scopes the licensing allocations to set.

--scope-environment-id

Environment ID that scopes the licensing allocations to set.

--scope-resource-id

Resource ID that scopes the licensing allocations to set.

--scope-tenant-id

Tenant ID that scopes the licensing allocations to set.

--scope-user-group-id

User group ID that scopes the licensing allocations to set.

--scope-user-id

User ID that scopes the licensing allocations to set.

pac licensing refresh-provisioning-status

(Preview) Refresh the billing policy provisioning status.

Required Parameters for licensing refresh-provisioning-status

--billing-policy-id

The billing policy ID.

pac licensing remove-billing-policy-environment

(Preview) Unlink billing policy ID from environments.

Required Parameters for licensing remove-billing-policy-environment

--billing-policy-id

The billing policy ID.

Optional Parameters for licensing remove-billing-policy-environment

--environment-ids

Provide the value as a JSON array.

pac licensing retrieve-temporary-currency-entitlement-count

(Preview) Get the temporary currency count and limit for the month by type.

Required Parameters for licensing retrieve-temporary-currency-entitlement-count

--currency-type

The currency type.

Use one of these values:

• AI
• AppPass
• AppPassForTeams
• Invoice
• MCSSessions
• MCSMessages
• PAHostedRPA
• PAUnattendedRPA
• PerFlowPlan
• PortalAddOns
• PortalLogins
• PortalViews
• PowerPagesAuthenticated
• PowerPagesAnonymous
• PowerAutomatePerProcess
• ProcessMiningDataStorage
• SCMessages
• VAConversations

pac licensing update-allocations-by-environment

(Preview) Update currency allocations and enforcement rules for an environment.

Optional Parameters for licensing update-allocations-by-environment

--currency-allocations

The per-currency allocations, including enforcement rules such as TenantPool that can be enabled or disabled. Provide the value as a JSON array.

--environment-id

The environment ID.

pac licensing update-billing-policy

(Preview) Updates the billing policy at tenant level.

Required Parameters for licensing update-billing-policy

--billing-policy-id

The billing policy ID.

Optional Parameters for licensing update-billing-policy

--name

Updated name for the tenant-level billing policy.

--status

The desired ISV contract status.

Use one of these values:

• Enabled
• Disabled

pac licensing update-isv-contract

(Preview) Update an ISV contract.

Required Parameters for licensing update-isv-contract

--isv-contract-id

The ISV contract ID.

Optional Parameters for licensing update-isv-contract

--conditions-api-filter

The Power Platform connector filter. Provide the value as a JSON object.

--name

Updated name for the ISV contract.

--power-automate-policy-cloud-flow-runs-pay-as-you-go-state

Updated pay-as-you-go state for cloud flow runs under the ISV contract.

Use one of these values:

• Enabled
• Disabled

--power-automate-policy-desktop-flow-attended-runs-pay-as-you-go-state

Updated pay-as-you-go state for attended desktop flow runs under the ISV contract.

Use one of these values:

• Enabled
• Disabled

--power-automate-policy-desktop-flow-unattended-runs-pay-as-you-go-state

Updated pay-as-you-go state for unattended desktop flow runs under the ISV contract.

Use one of these values:

• Enabled
• Disabled

--status

The desired ISV contract status.

Use one of these values:

• Enabled
• Disabled

pac licensing upsert-resource-threshold

(Preview) Create or update the resource threshold for an environment resource.

Required Parameters for licensing upsert-resource-threshold

--entitlement-id

The entitlement ID.

--resource-id

The resource ID.

Optional Parameters for licensing upsert-resource-threshold

--environment -env

Specifies the target Dataverse. The value may be a Guid or absolute https URL. When not specified, the active organization selected for the current auth profile will be used.

--limit

Licensing consumption limit for the environment resource threshold.

--notification-threshold

Consumption threshold at which to notify users about the environment resource.

--notify-if-over-capacity

Whether to send a notification when the environment resource exceeds allocated capacity.

--resource-consumption

Current consumption value for the environment resource threshold.

--stop-if-over-capacity

Whether to stop the environment resource when it exceeds allocated capacity.

--stop-resource

Whether to stop the environment resource when its licensing threshold is exceeded.

See also

Microsoft Power Platform CLI Command Groups
Microsoft Power Platform CLI overview