Share via

Add-FinOpsServicePrincipal command

The Add-FinOpsServicePrincipal command grants the specified service principal or managed identity access to an Enterprise Agreement billing account or department.

For more information about granting roles to service principals, see Assign Enterprise Agreement roles to service principals. For more information about the permissions associated with each role, see Usage and costs access by role.


Syntax

Add-FinOpsServicePrincipal `
    -ObjectId 00000000-0000-0000-0000-000000000000 `
    -TenantId 00000000-0000-0000-0000-000000000000 `
    -BillingAccountId 12345 `
    -DepartmentId 67890

Parameters

Name Description
ObjectId Required. The object ID of the service principal or managed identity.
TenantId Required. The Azure Active Directory tenant which contains the identity.
BillingAccountId Required. The billing account ID (enrollment number) to grant permissions against.
DepartmentId Optional. The department ID to grant permissions against.

Examples

The following examples demonstrate how to use the Add-FinOpsServicePrincipal command to deploy or update a FinOps hub instance.

Enterprise Administrator (read only)

Add-FinOpsServicePrincipal `
    -ObjectId 00000000-0000-0000-0000-000000000000 `
    -TenantId 00000000-0000-0000-0000-000000000000 `
    -BillingAccountId 12345

Grants Enterprise Administrator (read only) permissions to the specified service principal or managed identity.

Department Administrator (read only)

Add-FinOpsServicePrincipal `
    -ObjectId 00000000-0000-0000-0000-000000000000 `
    -TenantId 00000000-0000-0000-0000-000000000000 `
    -BillingAccountId 12345 `
    -DepartmentId 67890

Grants Department Administrator (read only) permissions to the specified service principal or managed identity.


Give feedback

Let us know how we're doing with a quick review. We use these reviews to improve and expand FinOps tools and resources.

Give feedback

If you're looking for something specific, vote for an existing or create a new idea. Share ideas with others to get more votes. We focus on ideas with the most votes.

Vote on or suggest ideas


Related content

Related solutions: