az devops security group

Note

此參考文獻是該Azure CLIazure-devops擴充套件（版本 2.30.0 或更高版本）的一部分。 擴充功能會在您第一次執行 az devops 安全組 命令時自動安裝。 深入了解擴充功能。

管理安全組。

命令

名稱	Description	類型	狀態
az devops security group create	建立一個新的 Azure DevOps 群組。	Extension	GA
az devops security group delete	Delete an Azure DevOps group.	Extension	GA
az devops security group list	列出專案或組織中的所有群組。	Extension	GA
az devops security group membership	管理安全組的成員資格。	Extension	GA
az devops security group membership add	新增成員資格。	Extension	GA
az devops security group membership list	列出群組或用戶的成員資格。	Extension	GA
az devops security group membership remove	拿掉成員資格。	Extension	GA
az devops security group show	顯示群組詳細數據。	Extension	GA
az devops security group update	更新 Azure DevOps 群組的名稱 AND/OR 描述。	Extension	GA

az devops security group create

建立一個新的 Azure DevOps 群組。

az devops security group create [--acquire-policy-token]
                                [--change-reference]
                                [--description]
                                [--detect {false, true}]
                                [--email-id]
                                [--groups]
                                [--name]
                                [--org --organization]
                                [--origin-id]
                                [--project]
                                [--scope {organization, project}]

範例

建立一個 Azure DevOps 群組，名稱與描述

az devops security group create --name 'Some group name'
--description 'Something to describe this group'

將現有的 AAD 群組加入 Azure DevOps 群組

Get object ID of an existing AAD group
az ad group show -g '{Group Name}'
az devops security group create --origin-id '{Object ID}' --groups 'vssgp.someDescriptorForGroup'

將現有的 AAD 群組加入 Azure DevOps 群組，並搭配 AAD 群組電子郵件 ID

az devops security group create --email-id '{Email ID of AAD group}'
--groups 'vssgp.someDescriptorForGroup'

建立一個新的 Azure DevOps 群組，並將其加入現有的 Azure DevOps 群組。

az devops security group create --name 'Some group name'
--groups 'vssgp.someDescriptorForGroupOne,vssgp.someDescriptorForGroupTwo'

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--description

Azure DevOps 群組說明。

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--email-id

使用郵件地址作為外部 AD 或 AAD 支援提供者現有群組的參考，建立新的群組。 如果遺漏名稱或 origin-id，則為必要專案。

--groups

以逗號分隔的描述元清單，參考您想要新建立的群組加入群組。

--name

Name of Azure DevOps group.

--org --organization

Azure DevOps organization URL. 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

--origin-id

使用 OriginID 作為外部 AD 或 AAD 支援提供者現有群組的參考，建立新的群組。 如果遺漏名稱或電子郵件標識碼，則為必要專案。

--project -p

Azure DevOps 群組應建立的專案名稱或 ID。

--scope

在專案或組織層級建立群組。

屬性	值
預設值:	project
接受的值:	organization, project

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az devops security group delete

Delete an Azure DevOps group.

az devops security group delete --id
                                [--acquire-policy-token]
                                [--change-reference]
                                [--detect {false, true}]
                                [--org --organization]
                                [--yes]

必要參數

--id

群組的描述元。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--org --organization

Azure DevOps organization URL. 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az devops security group list

列出專案或組織中的所有群組。

az devops security group list [--continuation-token]
                              [--detect {false, true}]
                              [--org --organization]
                              [--project]
                              [--scope {organization, project}]
                              [--subject-types]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--continuation-token

如果單一頁面中無法傳回更多結果，結果集將會包含接續令牌，以便擷取下一組結果。

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--org --organization

Azure DevOps organization URL. 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

--project -p

列出特定專案的群組。

--scope

列出專案或組織層級的群組。

屬性	值
預設值:	project
接受的值:	organization, project

--subject-types

以逗號分隔的使用者主旨子類型清單，以減少擷取的結果。 您可以提供描述元的初始部分 [在點之前] 做為篩選，例如 vssgp，aadgp。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az devops security group show

顯示群組詳細數據。

az devops security group show --id
                              [--detect {false, true}]
                              [--org --organization]

必要參數

--id

群組的描述元。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--org --organization

Azure DevOps organization URL. 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az devops security group update

更新 Azure DevOps 群組的名稱 AND/OR 描述。

az devops security group update --id
                                [--acquire-policy-token]
                                [--change-reference]
                                [--description]
                                [--detect {false, true}]
                                [--name]
                                [--org --organization]

必要參數

--id

群組的描述元。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--description

Azure DevOps group 的新描述.

--detect

自動偵測組織。

屬性	值
接受的值:	false, true

--name

Azure DevOps group 的新名稱。

--org --organization

Azure DevOps organization URL. 您可以使用 az devops configure -d organization=ORG_URL 來設定預設組織。 如果未設定為預設，或透過 git 組態挑選，則為必要專案。範例：https://dev.azure.com/MyOrganizationName/。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False