Freigeben über

az devops security group

  • Referenz

Hinweis

Diese Referenz ist Teil der azure-devops--Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird beim ersten Ausführen einer az devops-Sicherheitsgruppe Befehl automatisch installiert. Erfahren Sie mehr über Erweiterungen.

Verwalten von Sicherheitsgruppen.

Befehle

Name Beschreibung Typ Status
az devops security group create

Erstellen Sie eine neue Azure DevOps-Gruppe.

 Erweiterung GA
az devops security group delete

Löschen Sie eine Azure DevOps-Gruppe.

 Erweiterung GA
az devops security group list

Listet alle Gruppen in einem Projekt oder einer Organisation auf.

 Erweiterung GA
az devops security group membership

Verwalten von Mitgliedschaften für Sicherheitsgruppen.

 Erweiterung GA
az devops security group membership add

Mitgliedschaft hinzufügen.

 Erweiterung GA
az devops security group membership list

Listet Mitgliedschaften für eine Gruppe oder einen Benutzer auf.

 Erweiterung GA
az devops security group membership remove

Mitgliedschaft entfernen.

 Erweiterung GA
az devops security group show

Gruppendetails anzeigen.

 Erweiterung GA
az devops security group update

Aktualisieren Sie den Namen UND/ODER die Beschreibung für eine Azure DevOps-Gruppe.

 Erweiterung GA

az devops security group create

Erstellen Sie eine neue Azure DevOps-Gruppe.

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

Beispiele

Erstellen einer Azure DevOps-Gruppe mit Name und Beschreibung

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

Hinzufügen einer vorhandenen AAD-Gruppe zu einer Azure DevOps-Gruppe

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'

Hinzufügen einer vorhandenen AAD-Gruppe zu einer Azure DevOps-Gruppe mit AAD-Gruppen-E-Mail-ID

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

Erstellen Sie eine neue Azure DevOps-Gruppe, und fügen Sie sie vorhandenen Azure DevOps-Gruppen hinzu.

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

Optionale Parameter

--description

Beschreibung der Azure DevOps-Gruppe.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--email-id

Erstellen Sie eine neue Gruppe mithilfe der E-Mail-Adresse als Verweis auf eine vorhandene Gruppe von einem externen AD- oder AAD-gesicherten Anbieter. Erforderlich, wenn Name oder Ursprungs-ID fehlt.

--groups

Eine durch Trennzeichen getrennte Liste von Deskriptoren, die auf Gruppen verweisen, der die neu erstellte Gruppe beitreten soll.

--name

Name der Azure DevOps-Gruppe.

--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--origin-id

Erstellen Sie eine neue Gruppe mit der OriginID als Verweis auf eine vorhandene Gruppe von einem externen AD- oder AAD-gesicherten Anbieter. Erforderlich, wenn Name oder E-Mail-ID fehlt.

--project -p

Name oder ID des Projekts, in dem die Azure DevOps-Gruppe erstellt werden soll.

--scope

Gruppe auf Projekt- oder Organisationsebene erstellen.

Zulässige Werte: organization, project
Standardwert: project
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az devops security group delete

Löschen Sie eine Azure DevOps-Gruppe.

az devops security group delete --id
                                [--detect {false, true}]
                                [--org]
                                [--yes]

Erforderliche Parameter

--id

Deskriptor der Gruppe.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az devops security group list

Listet alle Gruppen in einem Projekt oder einer Organisation auf.

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

Optionale Parameter

--continuation-token

Wenn mehr Ergebnisse vorhanden sind, die nicht auf einer einzelnen Seite zurückgegeben werden können, enthält das Resultset ein Fortsetzungstoken zum Abrufen der nächsten Ergebnisgruppe.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

--project -p

Listen Sie Gruppen für ein bestimmtes Projekt auf.

--scope

Listen Sie Gruppen auf Projekt- oder Organisationsebene auf.

Zulässige Werte: organization, project
Standardwert: project
--subject-types

Eine durch Trennzeichen getrennte Liste der Untertypen des Benutzerthemas, um die abgerufenen Ergebnisse zu reduzieren. Sie können als Filter z. B. vssgp,aadgp einen Ersten Teil des Deskriptors [vor dem Punkt] geben.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az devops security group show

Gruppendetails anzeigen.

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

Erforderliche Parameter

--id

Deskriptor der Gruppe.

Optionale Parameter

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az devops security group update

Aktualisieren Sie den Namen UND/ODER die Beschreibung für eine Azure DevOps-Gruppe.

az devops security group update --id
                                [--description]
                                [--detect {false, true}]
                                [--name]
                                [--org]

Erforderliche Parameter

--id

Deskriptor der Gruppe.

Optionale Parameter

--description

Neue Beschreibung für die Azure DevOps-Gruppe.

--detect

Organisation automatisch erkennen.

Zulässige Werte: false, true
--name

Neuer Name für die Azure DevOps-Gruppe.

--org --organization

Azure DevOps-organization-URL. Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn sie nicht als Standard konfiguriert oder über die Git-Konfiguration aufgenommen wurde. Beispiel: https://dev.azure.com/MyOrganizationName/.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.