Freigeben über

az devops security group

Note

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.

 Extension GA
az devops security group delete

Löschen Sie eine Azure DevOps-Gruppe.

 Extension GA
az devops security group list

Listet alle Gruppen in einem Projekt oder einer Organisation auf.

 Extension GA
az devops security group membership

Verwalten von Mitgliedschaften für Sicherheitsgruppen.

 Extension GA
az devops security group membership add

Mitgliedschaft hinzufügen.

 Extension GA
az devops security group membership list

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

 Extension GA
az devops security group membership remove

Mitgliedschaft entfernen.

 Extension GA
az devops security group show

Gruppendetails anzeigen.

 Extension GA
az devops security group update

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

 Extension 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 --organization]
                                [--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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--description

Beschreibung der Azure DevOps-Gruppe.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
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.

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

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

az devops security group delete

Löschen Sie eine Azure DevOps-Gruppe.

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

Erforderliche Parameter

--id

Deskriptor der Gruppe.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
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.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

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 --organization]
                              [--project]
                              [--scope {organization, project}]
                              [--subject-types]

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--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.

Eigenschaft Wert
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.

Eigenschaft Wert
Standardwert: project
Zulässige Werte: organization, 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.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

az devops security group show

Gruppendetails anzeigen.

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

Erforderliche Parameter

--id

Deskriptor der Gruppe.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
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.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

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 --organization]

Erforderliche Parameter

--id

Deskriptor der Gruppe.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--description

Neue Beschreibung für die Azure DevOps-Gruppe.

--detect

Organisation automatisch erkennen.

Eigenschaft Wert
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.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False