Freigeben über

az devcenter admin project-environment-type

  • Referenz

Hinweis

Diese Referenz ist Teil der Devcenter-Erweiterung für die Azure CLI (Version 2.51.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az devcenter-Administrator-Projektumgebungstyp-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten von Projektumgebungstypen.

Befehle

Name Beschreibung Typ Status
az devcenter admin project-environment-type create

Erstellen Sie einen Projektumgebungstyp.

 Erweiterung Allgemein verfügbar
az devcenter admin project-environment-type delete

Löschen eines Projektumgebungstyps

 Erweiterung Allgemein verfügbar
az devcenter admin project-environment-type list

Auflisten von Umgebungstypen für ein Projekt.

 Erweiterung Allgemein verfügbar
az devcenter admin project-environment-type show

Rufen Sie einen Projektumgebungstyp ab.

 Erweiterung Allgemein verfügbar
az devcenter admin project-environment-type update

Aktualisieren eines Projektumgebungstyps

 Erweiterung Allgemein verfügbar

az devcenter admin project-environment-type create

Erstellen Sie einen Projektumgebungstyp.

az devcenter admin project-environment-type create --deployment-target-id
                                                   --environment-type-name
                                                   --identity-type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}
                                                   --project
                                                   --resource-group
                                                   --roles
                                                   --status {Disabled, Enabled}
                                                   [--display-name]
                                                   [--location]
                                                   [--tags]
                                                   [--user-assigned-identities]
                                                   [--user-role-assignments]

Beispiele

Erstellen

az devcenter admin project-environment-type create --identity-type "UserAssigned" --user-assigned-identities "{\"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/identityGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity1\":{}}" --roles "{\"4cbf0b6c-e750-441c-98a7-10da8387e4d6\":{}}" --deployment-target-id "/subscriptions/00000000-0000-0000-0000-000000000000" --status "Enabled" --user-role-assignments "{\"e45e3m7c-176e-416a-b466-0c5ec8298f8a\":{\"roles\":{\"4cbf0b6c-e750-441c-98a7-10da8387e4d6\":{}}}}" --tags CostCenter="RnD" --environment-type-name "DevTest" --project-name "ContosoProj" --resource-group "rg1"

Erforderliche Parameter

--deployment-target-id

ID eines Abonnements, dem der Umgebungstyp zugeordnet wird. Die Ressourcen der Umgebung werden in diesem Abonnement bereitgestellt.

--environment-type-name --name -n

Der Name des Umgebungstyps.

--identity-type

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

Zulässige Werte: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--project --project-name

Der Name des Projekts. Wird az configure -d project=<project_name> verwendet, um einen Standardwert zu konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--roles

Eine Zuordnung von Rollen, die dem Ersteller der Umgebung zugewiesen werden sollen. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--status

Definiert, ob dieser Umgebungstyp in diesem Projekt verwendet werden kann.

Zulässige Werte: Disabled, Enabled

Optionale Parameter

--display-name

Der Anzeigename des Projektumgebungstyps.

--location -l

Der geografische Standort, an dem sich die Ressource befindet. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--tags

Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--user-assigned-identities -u

Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--user-role-assignments

Rollenzuweisungen, die für die Umgebungssicherung von Ressourcen erstellt wurden. Dies ist eine Zuordnung von einer Benutzerobjekt-ID zu einem Objekt mit Rollendefinitions-IDs. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

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 devcenter admin project-environment-type delete

Löschen eines Projektumgebungstyps

az devcenter admin project-environment-type delete [--environment-type-name]
                                                   [--ids]
                                                   [--project]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--yes]

Beispiele

Löschen

az devcenter admin project-environment-type delete --environment-type-name "DevTest" --project-name "ContosoProj" --resource-group "rg1"

Optionale Parameter

--environment-type-name --name -n

Der Name des Umgebungstyps.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--project --project-name

Der Name des Projekts. Wird az configure -d project=<project_name> verwendet, um einen Standardwert zu konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

--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 devcenter admin project-environment-type list

Auflisten von Umgebungstypen für ein Projekt.

az devcenter admin project-environment-type list --project
                                                 --resource-group
                                                 [--max-items]
                                                 [--next-token]

Beispiele

Liste

az devcenter admin project-environment-type list --project-name "ContosoProj" --resource-group "rg1"

Erforderliche Parameter

--project --project-name

Der Name des Projekts. Wird az configure -d project=<project_name> verwendet, um einen Standardwert zu konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--max-items

Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert im --next-token Argument eines nachfolgenden Befehls an.

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

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 devcenter admin project-environment-type show

Rufen Sie einen Projektumgebungstyp ab.

az devcenter admin project-environment-type show [--environment-type-name]
                                                 [--ids]
                                                 [--project]
                                                 [--resource-group]
                                                 [--subscription]

Beispiele

Get

az devcenter admin project-environment-type show --environment-type-name "DevTest" --project-name "ContosoProj" --resource-group "rg1"

Optionale Parameter

--environment-type-name --name -n

Der Name des Umgebungstyps.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--project --project-name

Der Name des Projekts. Wird az configure -d project=<project_name> verwendet, um einen Standardwert zu konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

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 devcenter admin project-environment-type update

Aktualisieren eines Projektumgebungstyps

az devcenter admin project-environment-type update [--add]
                                                   [--deployment-target-id]
                                                   [--display-name]
                                                   [--environment-type-name]
                                                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--identity-type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                                                   [--ids]
                                                   [--project]
                                                   [--remove]
                                                   [--resource-group]
                                                   [--roles]
                                                   [--set]
                                                   [--status {Disabled, Enabled}]
                                                   [--subscription]
                                                   [--tags]
                                                   [--user-assigned-identities]
                                                   [--user-role-assignments]

Beispiele

Aktualisieren

az devcenter admin project-environment-type update --identity-type "UserAssigned" --user-assigned-identities "{"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/identityGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity1":{}}" --deployment-target-id "/subscriptions/00000000-0000-0000-0000-000000000000" --status "Enabled" --user-role-assignments "{"e45e3m7c-176e-416a-b466-0c5ec8298f8a":{"roles":{"4cbf0b6c-e750-441c-98a7-10da8387e4d6":{}}}}" --tags CostCenter="RnD" --environment-type-name "DevTest" --project-name "ContosoProj" --resource-group "rg1"

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--deployment-target-id

ID eines Abonnements, dem der Umgebungstyp zugeordnet wird. Die Ressourcen der Umgebung werden in diesem Abonnement bereitgestellt.

--display-name

Der Anzeigename des Projektumgebungstyps.

--environment-type-name --name -n

Der Name des Umgebungstyps.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--identity-type

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

Zulässige Werte: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--project --project-name

Der Name des Projekts. Wird az configure -d project=<project_name> verwendet, um einen Standardwert zu konfigurieren.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--roles

Eine Zuordnung von Rollen, die dem Ersteller der Umgebung zugewiesen werden sollen. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.

--status

Definiert, ob dieser Umgebungstyp in diesem Projekt verwendet werden kann.

Zulässige Werte: Disabled, Enabled
--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.

--tags

Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--user-assigned-identities -u

Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--user-role-assignments

Rollenzuweisungen, die für die Umgebungssicherung von Ressourcen erstellt wurden. Dies ist eine Zuordnung von einer Benutzerobjekt-ID zu einem Objekt mit Rollendefinitions-IDs. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

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.