[PowerShell] New-FinOpsServicePrincipal – Manage billing account service principals

[flanakin]

📝 Scenario

As an Enterprise Agreement billing account administrator, I need to create service principals in order to automate Cost Management and Billing API integration

💎 Solution

Create functions to manage service principals for EA accounts:

• Add-<prefix>ServicePrincipal
• Get-<prefix>ServicePrincipal
• Remove-<prefix>ServicePrincipal
• Update-<prefix>ServicePrincipal

https://learn.microsoft.com/azure/cost-management-billing/manage/assign-roles-azure-service-principals#assign-enrollment-account-role-permission-to-the-spn

We need to determine what prefix we want to use for these, since this isn't a native Az module function. Some ideas:

• FinOps if we want to maintain branding of the toolkit/module.
• Toolkit if we want to be very explicit that this is a toolkit feature. Main downside is the length.
• Azure to differentiate from anything we might do in the future for non-Azure clouds (e.g., manage
• Billing since this only applies to billing scopes.
• Account if we want to support each billing scope in its own function. (I'm thinking one for all scopes with a -Scope parameter for simplicity.)

Examples:

• Add-FinOpsToolkitAzureBillingAccountServicePrincipal
• Add-FinOpsAzureBillingServicePrincipal
• Add-AzureBillingServicePrincipal
• Add-FinOpsServicePrincipal

🙋‍♀️ Ask for the community

We could use your help:

1. Please vote this issue up (👍) to prioritize it.
2. Leave comments to help us solidify the vision.