使用指令碼將計費角色從某個 MCA 複製到跨租用戶的另一個 MCA

發行項
2025-01-22

Azure 入口網站會自動進行訂用帳戶移轉，但不會自動移轉角色。本文中的資訊可協助計費帳戶擁有者在合併 Microsoft 客戶合約 (MCA) 企業帳戶時自動指派角色。您可以使用指令碼，將計費角色從某個 MCA 企業帳戶複製到跨租用戶的另一個 MCA 企業帳戶。下列範例案例描述整體流程。

Contoso Ltd 收購 Fabrikam, Inc.Contoso 和 Fabrikam 在各自的租用戶中都有一個 MCA。 Contoso 想要將 Fabrikam 訂用帳戶的計費管理帶入自己的 Contoso MCA 之下。此外，Contoso 也想為 Fabrikam 訂用帳戶產生個別發票，並讓 Fabrikam 租用戶中的使用者指派為計費角色。

Contoso MCA 計費帳戶擁有者會使用下列流程：

建立 Fabrikam 租用戶與 Contoso MCA 計費帳戶的關聯。
為 Fabrikam 訂用帳戶建立新的帳單設定檔。
將帳單設定檔擁有者角色指派給 Fabrikam 租用戶中的使用者。

請記住，來源 Fabrikam MCA 的計費帳戶、帳單設定檔和數個發票區段層級中，有許多具有計費角色的其他使用者。

在來源 MCA 的 Fabrikam「計費帳戶擁有者」角色獲得 Contoso (目標) MCA 的「計費帳戶擁有者」角色之後，他們會使用下列各節，將計費角色從來源 MCA 自動移轉至目標 MCA。

使用下列資訊，將計費角色從來源 (Fabrikam) MCA 自動移轉至目標 (Contoso) MCA。指令碼適用於帳單設定檔範圍。

必要條件

您必須擁有目標 MCA 上的計費帳戶擁有者角色，以及來源 MCA 上的計費帳戶擁有者或計費帳戶參與者角色。
為指令碼準備的儲存體帳戶。如需詳細資訊，請參閱開始使用 AzCopy。

準備目標環境

登入 Azure 入口網站，使用的帳戶必須擁有目標租用戶 MCA 計費帳戶的必要權限。
產生來源租用戶與目標 MCA 計費帳戶的關聯。如需詳細資訊，請參閱新增相關聯的計費租用戶。
從相關聯的租用戶中新增計費帳戶擁有者。如需詳細資訊，請參閱指派角色給相關聯計費租用戶中的使用者。
在目標租用戶中，視需要新增帳單設定檔和發票區段。

準備並執行指令碼

使用下列步驟來準備並執行指令碼。

從角色移轉指令碼範例一節中，複製指令碼範例。
貼上，然後在本機將檔案另存為 PS1 檔案。
使用下列項目的來源目標對應來更新指令碼：
- Tenant
- Billing account
- Billing profile
- Invoice sections
登入 Azure 入口網站 (來源租用戶)，然後開啟 Cloud Shell。如果系統提示您選取 Bash 或 PowerShell，請選取 [PowerShell]。
如果您先前使用 Bash，請在 Cloud Shell 工具列中選取 [PowerShell]。
將 PS1 檔案上傳至您的 Azure 儲存體帳戶。
執行 PS1 檔案。
向 Azure Cloud Shell 進行驗證。
在執行指令碼之後，確認角色位於目標 MCA 中。

角色移轉指令碼範例

您可以使用下列範例指令碼，自動移轉計費角色。角色會從來源 MCA 帳單設定檔複製到不同租用戶中的目標 MCA 帳單設定檔。

## Define source target mapping for
##	1. Tenant
##	2. Billing Account
##	3. Billing Profile
##	4. Invoice Sections
##(source) MCA-E details
$tenantId = "" 
$billingAccount=""
$billingProfile = ""
##(destination) MCA-E details
$targetBillingProfile = ""
$targetTenantId = ""
$targetbillingAccount=""
## Invoice section mapping in hash table
$hash = @{
"" = ""; #invoice section 1
"" = ""; #invoice section 2
}
## Connect to Azure account using device authentication using tenantId
Connect-AzAccount -UseDeviceAuthentication -TenantId $tenantId
Set-AzContext -TenantId $tenantId
## Acquire access token for the current user
$var = Get-AzAccessToken
$auth = 'Bearer ' + $var.Token
#### Get Billing Account Role Assignments from source MCA-E
#define parameters for REST API call
$params = @{
    Uri         = "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/"+ $billingAccount +"/billingRoleAssignments?api-version=2019-10-01-preview"
    Headers     = @{ 'Authorization' = $auth }
    Method      = 'GET'
    ContentType = 'application/json'
}
#### Call API with parameters defined above
$ret = Invoke-RestMethod @params 
####Initialize array lists 
$ArrayListBARoles = [System.Collections.Generic.List[string]]::new();
$ArrayListBPRoles = [System.Collections.Generic.List[string]]::new();
$ArrayListISRoles = [System.Collections.Generic.List[string]]::new();
#### Add each billing account role and principal id to array list 
#### Push down the billing account role assignments to billing profile role assignments (replacing 5 series with 4 series)
foreach($j in $ret.value){                                                     
	$BANameArrayArray= $j.name -replace "500000", "500000" #-split '_'                                           
	foreach($i in $BANameArrayArray){
	 $ArrayListBARoles.Add($i)
	 }
 }
#### Get Billing Role assignments for billing profile
$paramsBPRoleAssignments = @{
	Uri         = "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/"+$billingAccount +"/billingProfiles/" +$billingProfile +"/billingRoleAssignments?api-version=2019-10-01-preview"
    Headers     = @{ 'Authorization' = $auth }
    Method      = 'GET'
    ContentType = 'application/json'
		}
$retBPRoles = Invoke-RestMethod @paramsBPRoleAssignments 
####add each role to arraylist
foreach($k in $retBPRoles.value){                                                     
	$BPNameArrayArray= $k.name #-split '_'                                           
	foreach($l in $BPNameArrayArray){
	$ArrayListBPRoles.Add($l)
	}
}
#### Get Invoice sections for billing profile
$invoiceSections = Get-AzInvoiceSection -BillingAccountName $billingAccount -BillingProfile $billingProfile
for ($ii=0; $ii -lt $ArrayListBARoles.count;  $ii=$ii+1){ 
	$paramsBARoleCreation = @{
		Uri = "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/"+$targetbillingAccount+"/createBillingRoleAssignment?api-version=2020-12-15-privatepreview"
		Headers     = @{ 'Authorization' = $auth }
		Method      = 'POST'
		ContentType = 'application/json'
		}
	$BodyBARoleCreation = @{
		principalTenantId = $tenantId
		roleDefinitionId = "/providers/Microsoft.Billing/billingAccounts/" +$targetbillingAccount +"/" +($ArrayListBARoles[$ii] -SPLIT '_')[0]
		principalId=($ArrayListBARoles[$ii] -SPLIT '_')[1]
		}
	$retBARoles = Invoke-RestMethod @paramsBARoleCreation -body @($BodyBARoleCreation | ConvertTo-Json)
}
#BILLING PROFILE	
for ($ii=0; $ii -lt $ArrayListBPRoles.count;  $ii=$ii+1){
	$paramsBPRoleCreation = @{
		Uri = "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/" +$targetbillingAccount +"/billingProfiles/"+ $targetBillingProfile +"/createBillingRoleAssignment?api-version=2020-12-15-privatepreview"
		Headers     = @{ 'Authorization' = $auth }
		Method      = 'POST'
		ContentType = 'application/json'
	}
	$BodyBPRoleCreation = @{
		principalTenantId = $tenantId
		roleDefinitionId = "/providers/Microsoft.Billing/billingAccounts/" +$targetbillingAccount +"/billingProfiles/"+ $targetBillingProfile +"/" +($ArrayListBPRoles[$ii] -SPLIT '_')[0]
		principalId=($ArrayListBPRoles[$ii] -SPLIT '_')[1]
    }
	$retBPRoles = Invoke-RestMethod @paramsBPRoleCreation -body @($BodyBPRoleCreation | ConvertTo-Json)
}
#INVOICE SECTIONS
$targetinvoiceSection=""
#Get Roles for each invoice section
foreach ($m in $invoiceSections){
	if ($hash.ContainsKey($m.Name)){
		$targetinvoiceSection=$hash[$m.Name]
		'targetinvoiceSection'
		$targetinvoiceSection
		
	$paramsISRoleAssignments = @{
		Uri = "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/" +$billingAccount +"/billingProfiles/" + $billingProfile +"/invoiceSections/" +$m.Name+ "/billingRoleAssignments?api-version=2019-10-01-preview"			
		Headers     = @{ 'Authorization' = $auth }
		Method      = 'GET'
		ContentType = 'application/json'
	}
	$retISRoles = Invoke-RestMethod @paramsISRoleAssignments 
	$ISNameArrayArray=$null
	$ArrayListISRoles = [System.Collections.Generic.List[string]]::new();
	foreach($n in $retISRoles.value){  
		$ISNameArrayArray= $n.name #-split '_'                                           
			foreach($o in $ISNameArrayArray){
				$ArrayListISRoles.Add($o)
			}
	}
		for ($ii=0; $ii -lt $ArrayListISRoles.count;  $ii=$ii+1){
			$paramsISRoleCreation = @{
				Uri = "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/" +$targetbillingAccount+ "/billingProfiles/"+ $targetBillingProfile +"/invoiceSections/"+ $targetinvoiceSection +"/createBillingRoleAssignment?api-version=2020-12-15-privatepreview"
				Headers     = @{ 'Authorization' = $auth }
				Method      = 'POST'
				ContentType = 'application/json'
			}
			$BodyISRoleCreation = @{
				principalTenantId = $tenantId
				roleDefinitionId = "/providers/Microsoft.Billing/billingAccounts/" +$targetbillingAccount +"/billingProfiles/"+ $targetBillingProfile +"/invoiceSections/"+ $targetinvoiceSection+ "/" +($ArrayListISRoles[$ii] -SPLIT '_')[0]
				#userEmailAddress = ($graph.UserPrincipalName -Replace '_', '@' -split '#EXT#@' )[0]
				principalId=($ArrayListISRoles[$ii] -SPLIT '_')[1]
			}
			$resISRolesCreation= Invoke-RestMethod @paramsISRoleCreation -body @($BodyISRoleCreation | ConvertTo-Json)
		}
		}
}

下一步

如有必要，請使用 [在 Azure 入口網站中管理計費角色] 中的資訊，授與存取權給計費帳戶、帳單設定檔和發票區段。

共用方式為

使用指令碼將計費角色從某個 MCA 複製到跨租用戶的另一個 MCA

必要條件

準備目標環境

準備並執行指令碼

角色移轉指令碼範例

下一步

意見反應

其他資源