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 automatisch installiert, wenn Sie einen az devops-Sicherheitsgruppenbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Sicherheitsgruppen

Befehle

Name Beschreibung Typ Status
az devops security group create

Erstellen Sie eine neue Azure DevOps-Gruppe.

 Durchwahl Allgemein verfügbar
az devops security group delete

Löschen Sie eine Azure DevOps-Gruppe.

 Durchwahl Allgemein verfügbar
az devops security group list

Listet alle Gruppen in einem Projekt oder einer Organisation auf.

 Durchwahl Allgemein verfügbar
az devops security group membership

Verwalten von Mitgliedschaften für Sicherheitsgruppen.

 Durchwahl Allgemein verfügbar
az devops security group membership add

Mitgliedschaft hinzufügen.

 Durchwahl Allgemein verfügbar
az devops security group membership list

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

 Durchwahl Allgemein verfügbar
az devops security group membership remove

Mitgliedschaft entfernen.

 Durchwahl Allgemein verfügbar
az devops security group show

Gruppendetails anzeigen.

 Durchwahl Allgemein verfügbar
az devops security group update

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

 Durchwahl Allgemein verfügbar

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-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. 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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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-Organisations-URL. Sie können die Standardorganisation mithilfe von „az devops configure -d organization=ORG_URL“ konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und 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

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.