﻿# 現有的 Azure 用戶如何快速與我們建立微軟合作夥伴連結

我們公司是**微軟金級合作夥伴**(Gold Certified Partner)，每當有客戶跟我們購買 Azure 或 Microsoft 365 的時候，我們多少都會提供一些免費的技術支援，提供一些設定上的協助。如果是直接跟我們購買**訂閱**(Subscription)的客戶，通常不太需要特別設定**建立合作夥伴連結**，但是你如果原本就有訂閱，後來才找我們購買的人，就可能會沒有設定到，此時就需要特別與我們建立合作夥伴連結。這篇文章我將說明建立合作夥伴連結的三種方式。

### 為什麼要建立合作夥伴連結

因為微軟每年都會對合作夥伴進行考核，所以我們每年都要達到一定的業績額度以上，才能通過考核。而業績的計算標準，主要就是看客戶的 Azure 訂用帳戶有沒有與合作夥伴建立連結關係。

你所建立的 Azure **組織**(Tenant)如果沒有現成可服務的**微軟合作夥伴**，其實設定與不設定對你是沒有任何差別的，但如果你直接與我們公司建立連結，日後要是你在 Azure 遇到一些問題的時候，我們也可以名正言順的提供你各種協助！👍

其實**建立合作夥伴連結**並不會將**訂用帳戶**(Subscription)授權給我們，這個**合作夥伴連結**主要是針對**組織**(Tenant)進行關聯的，其實最終會影響到的，只有我們在**微軟合作夥伴計畫**中的**業績表現**而已。

### 使用 Azure Portal 建立合作夥伴連結

首先，你的登入帳號必須是 **組織** (Tenant) 的 **帳號管理員** (Account Admin)，然後就可以透過本篇文章的方法進行設定。

如果你是知道如何操作 Azure Portal 的客戶，這個設定方式應該是最簡單的，兩個步驟就可以完成：

1.  開啟 [連結到合作夥伴 ID](https://portal.azure.com/#blade/Microsoft_Azure_Billing/ManagementPartnerBlade) 頁面 ([Link to a partner ID](https://portal.azure.com/#blade/Microsoft_Azure_Billing/ManagementPartnerBlade))
    
    > https://portal.azure.com/#blade/Microsoft\_Azure\_Billing/ManagementPartnerBlade
    
    請檢查一下是否有如下圖的 **目前的合作夥伴** (**Current partner**) 資訊，那就是你還沒有跟任何合作夥伴連結：
    
    ![連結到合作夥伴 ID](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/8c449e882af2b0c1f68c-180916024-46609170-5b34-43f2-a900-5d1c441eb3bf.png)
    
    ![Link to a partner ID](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/bd246bd6efaa85889761-180813732-488a3200-23dd-4ca7-9f50-9d013eacae1b.png)
    
2.  設定 **Microsoft 合作夥伴識別碼** (**Microsoft partner ID**) 輸入 `811392`
    
    此時你可以在畫面上看到一個 **Microsoft 合作夥伴識別碼** (**Microsoft partner ID**) 輸入欄位，只要輸入我們公司的 **MPN ID** 號碼 `811392`，並按下 **連結合作夥伴 ID** (**Link a partner ID**) 按鈕，就可以連結完成。
    

### 使用 PowerShell 建立合作夥伴連結

對於不太熟悉 Azure Portal 的客戶，那就可以改用另一種方式來建立合作夥伴連結。

> 以下步驟只有第 3 步需要客戶介入，其他步驟都是我們來操作，所以門檻很低。

1.  安裝 PowerShell 的 [Az](https://learn.microsoft.com/zh-tw/powershell/azure/install-az-ps?view=azps-8.1.0&WT.mc_id=DT-MVP-4015686) 模組與 [Az.ManagementPartner](https://www.powershellgallery.com/packages/Az.ManagementPartner/) 模組
    
    ```powershell
    Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force
    
    Install-Module -Name Az.ManagementPartner
    ```
    
    > 文件: [安裝 Azure Az PowerShell 模組](https://learn.microsoft.com/zh-tw/powershell/azure/install-az-ps?view=azps-8.1.0&WT.mc_id=DT-MVP-4015686)
    
2.  使用客戶的身份登入 Azure 帳戶
    
    ```powershell
    Connect-AzAccount -UseDeviceAuthentication
    ```
    
    ```
    WARNING: To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code HD74VMW5S to authenticate.
    ```
    
    > 此時要把上述訊息的「連結」與「裝置代碼」傳給客戶。
    
3.  請客戶打開以下連結並在過程中輸入裝置代碼 (Device Code)
    
    > https://microsoft.com/devicelogin
    
    `HD74VMW5S`
    
4.  指派 MPN ID 的設定
    
    你可以用 `Get-AzManagementPartner` 命令查詢目前是否有跟合作夥伴連結：
    
    ```powershell
    Get-AzManagementPartner
    ```
    
    如果尚未與任何合作夥伴連結，你應該會看到以下錯誤訊息：
    
    ```
    Get-AzManagementPartner: Operation failed with message 'This user or service principal is not linked with a Partner ID'
    ```
    
    建立合作夥伴連結：
    
    ```powershell
    New-AzManagementPartner -PartnerId 811392
    ```
    
    如果已經建立過，執行時應該會看到以下錯誤訊息：
    
    ```
    New-AzManagementPartner: Operation failed with message 'This user or service principal is already linked with a Partner ID'
    ```
    
    更新合作夥伴的連結：
    
    ```powershell
    Update-AzManagementPartner -PartnerId 811392
    ```
    
5.  登出 Azure 帳戶
    
    ```powershell
    Disconnect-AzAccount
    ```
    

### 使用 Azure CLI 建立合作夥伴連結

對於不太熟悉 Azure Portal 的客戶，也可以改用 Azure CLI 來建立合作夥伴連結，這個方式可以在 Windows/Linux/macOS 跨平台支援。

> 以下步驟只有第 3 步需要客戶介入，其他步驟都是我們來操作，所以門檻很低。

1.  安裝 **Azure CLI** 與 `managementpartner` extension
    
    下載 [Azure CLI](https://aka.ms/installazurecliwindows) 使用 MSI 進行安裝，然後透過以下命令安裝 `managementpartner` 擴充。
    
    ```bash
    az extension add --name managementpartner
    ```
    
    > 文件: [How to install the Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?WT.mc_id=DT-MVP-4015686)
    
2.  使用客戶的身份登入 Azure 帳戶
    
    ```bash
    az login --use-device-code
    ```
    
    ```
    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code HLHD2UKCY to authenticate.
    ```
    
    > [`az login --use-device-code` should always show device code · Issue #23320 · Azure/azure-cli](https://github.com/Azure/azure-cli/issues/23320)
    
3.  請客戶打開以下連結並在過程中輸入裝置代碼 (Device Code)
    
    > https://microsoft.com/devicelogin
    
    `HLHD2UKCY`
    
4.  指派 MPN ID 的設定
    
    你可以用 `az managementpartner show` 命令查詢目前是否有跟合作夥伴連結：
    
    ```powershell
    az managementpartner show
    ```
    
    如果尚未與任何合作夥伴連結，你應該會看到以下錯誤訊息：
    
    ```
    ManagementPartnerNotFound: This user or service principal is not linked with a Partner ID
    ```
    
    建立合作夥伴連結：
    
    ```powershell
    az managementpartner create --partner-id 811392
    ```
    
    如果已經建立過，執行時應該會看到以下錯誤訊息：
    
    ```
    PartnerIdAlreadyLinked: This user or service principal is already linked with a Partner ID
    ```
    
    更新合作夥伴的連結：
    
    ```powershell
    az managementpartner update --partner-id 811392
    ```
    
5.  登出 Azure 帳戶
    
    ```powershell
    az account clear
    ```
    

### 相關連結

-   [Link a partner ID with PAL or DPOR](https://learn.microsoft.com/en-us/partner-center/link-partner-id-for-azure-performance-pal-dpor?WT.mc_id=DT-MVP-4015686)
    -   連結合作夥伴ID不代表能夠管理客戶的 Azure 服務，你還要從 Azure 訂用帳戶額外授權才行。這個連結動作純粹只是讓微軟審核合作夥伴的貢獻而已。
-   [Add a Partner of Record (POR) to your subscription](https://learn.microsoft.com/en-us/power-platform/admin/add-partner-record-subscription?WT.mc_id=DT-MVP-4015686)
    -   Microsoft 365 所有的訂閱產品，都各自可以輸入 MPN ID，這意味著不同的商品可以讓不同的合作夥伴提供服務。
-   [Azure PowerShell Documentation](https://learn.microsoft.com/en-us/powershell/azure/?view=azps-8.1.0&WT.mc_id=DT-MVP-4015686)
    -   [Sign in with Azure PowerShell](https://learn.microsoft.com/en-us/powershell/azure/authenticate-azureps?view=azps-8.1.0&WT.mc_id=DT-MVP-4015686)
-   [Azure Command-Line Interface (CLI) documentation](https://learn.microsoft.com/en-us/cli/azure/?WT.mc_id=DT-MVP-4015686)
    -   [Sign in with Azure CLI](https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli?WT.mc_id=DT-MVP-4015686)
