最近公司正在急速的成長，經常需要新增 Azure DevOps Services 使用者帳號並設定專案權限，我今天特別將這些步驟全部寫成指令碼，之後直接複製貼上就可以單鍵完成設定。
以下命令皆使用 PowreShell 進行示範。
安裝 Azure CLI 並安裝 Azure DevOps Services 擴充命令
-
安裝 Azure CLI 工具
choco install azure-cli -y
-
登入 Azure
az login
-
安裝 Azure DevOps Services 擴充命令
az extension add --name azure-devops
-
設定組織預設值
az devops configure --defaults organization=https://dev.azure.com/YourOrgName
新增使用者到 Azure DevOps Services 組織
新增到使用者，最主要有兩個設定：
-
輸入使用者的 E-mail 地址
這個 E-mail 地址可能是 微軟帳戶(Microsoft Account) 或 組織帳戶 (Organizational Account)
-
設定授權類型
你必須從 About access levels 的 Programmatic mapping of access levels 找到一個對應的 AccountLicenseType，目前可用的 AccountLicenseType 有 6 種：stakeholder, express, advanced, none, earlyAdopter, professional，但是常見大概只有前面 4 種！
以下我使用常見的 AccountLicenseType 分別說明新增使用者的指令：
我們假設 $UserPrincipalName 是 PowerShell 變數，並指向類似 user@hotmail.com 的電子郵件地址。
-
Stakeholder
az devops user add --email-id $UserPrincipalName --license-type "stakeholder"
-
Basic
az devops user add --email-id $UserPrincipalName --license-type "express"
-
Basic + Test Plans
az devops user add --email-id $UserPrincipalName --license-type "advanced"
-
Visual Studio subscriber
az devops user add --email-id $UserPrincipalName --license-type "none"
變更使用者 Azure DevOps 授權
由於 Azure DevOps 授權是以天計費的計價模式，如果使用者並不會立即使用 Azure DevOps 進階功能，這時可以設定比較便宜的授權，或是乾脆暫時設定為 stakeholder 免費的授權！
以下是更新 Azure DevOps 授權的指令範例：
-
Stakeholder
az devops user update --user $UserPrincipalName --license-type "stakeholder"
-
Basic
az devops user update --user $UserPrincipalName --license-type "express"
-
Basic + Test Plans
az devops user update --user $UserPrincipalName --license-type "advanced"
-
Visual Studio subscriber
az devops user update --user $UserPrincipalName --license-type "none"
新增使用者到特定專案下的特定群組
-
首先，我們要先確定你要把使用者加入到哪個專案
$AzDO_Project = "TDCC_Futures"
-
取得 Azure DevOps Services 特定專案的群組清單
# 取得 Azure DevOps Services 特定專案的群組清單
$AzDO_Groups = $(az devops security group list -p $AzDO_Project -o json | ConvertFrom-Json)
-
將成員加入 Contributors 群組
$AzDO_GroupName = "Contributors"
$AzDO_GroupId = ($AzDO_Groups.graphGroups | Where-Object "displayName" -in "$AzDO_GroupName").descriptor
az devops security group membership add --group-id $AzDO_GroupId --member-id $UserPrincipalName
如果要加入專案管理員群組，可以改成：
$AzDO_GroupName = "Project Administrators"
$AzDO_GroupId = ($AzDO_Groups.graphGroups | Where-Object "displayName" -in "$AzDO_GroupName").descriptor
az devops security group membership add --group-id $AzDO_GroupId --member-id $UserPrincipalName
目前預設的專案群組有：
- Contributors
- Project Administrators
- Build Administrators
- Project Valid Users
- Readers
- Release Administrators
- TeamName Team
-
列出使用者目前擁有權限的專案清單
$AzDO_Projects = $(az devops user show --user $UserPrincipalName -o json | ConvertFrom-Json)
$AzDO_Projects.projectEntitlements | ForEach-Object -Process {
# $_.projectRef.id
$_.projectRef.name
}
相關連結