az devcenter admin pool
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-Administratorpoolbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen
Verwalten von Pools.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az devcenter admin pool create |
Erstellen Sie einen Pool. |
Erweiterung | Allgemein verfügbar |
az devcenter admin pool delete |
Löschen eines Pools |
Erweiterung | Allgemein verfügbar |
az devcenter admin pool list |
Auflisten von Pools für ein Projekt. |
Erweiterung | Allgemein verfügbar |
az devcenter admin pool run-health-check |
Löst eine Aktualisierung des Poolstatus aus. |
Erweiterung | Allgemein verfügbar |
az devcenter admin pool show |
Rufen Sie einen Pool ab. |
Erweiterung | Allgemein verfügbar |
az devcenter admin pool update |
Aktualisieren eines Pools. |
Erweiterung | Allgemein verfügbar |
az devcenter admin pool wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist. |
Erweiterung | Allgemein verfügbar |
az devcenter admin pool create
Erstellen Sie einen Pool.
az devcenter admin pool create --local-administrator {Disabled, Enabled}
--name
--project
--resource-group
[--devbox-definition-image-reference]
[--devbox-definition-name]
[--devbox-definition-sku]
[--devbox-definition-type {Reference, Value}]
[--display-name]
[--location]
[--managed-virtual-network-regions]
[--network-connection-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--single-sign-on-status {Disabled, Enabled}]
[--stop-on-disconnect]
[--stop-on-no-connect]
[--tags]
[--virtual-network-type {Managed, Unmanaged}]
Beispiele
Erstellen eines Pools mithilfe eines nicht verwalteten Netzwerks
az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled"
Erstellen eines Pools mit verwaltetem Netzwerk
az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Managed" --managed-virtual-network-region ["westus3"] --single-sign-on-status "Enabled"
Erstellen eines Pools mit aktiviertem Beenden der Verbindung
az devcenter admin pool create --location "eastus" --devbox-definition-name "WebDevBox" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled" --stop-on-disconnect status="Enabled" grace-period-minutes="60"
Erstellen eines Pools mithilfe der Imagedefinition
az devcenter admin pool create --location "eastus" --network-connection-name "Network1-westus2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --local-administrator "Enabled" --virtual-network-type "Unmanaged" --single-sign-on-status "Enabled" --devbox-definition-type "Value" --devbox-definition-image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/rg1/providers/Microsoft.DevCenter/projects/DevProject/images/~Catalog~image2~project-sample-2" --devbox-definition-sku name=""general_i_8c32gb256ssd_v2"
Erforderliche Parameter
Gibt an, ob Besitzer von Entwicklungsfeldern in diesem Pool als lokale Administratoren im Entwicklerfeld hinzugefügt werden.
Name des Pools.
Der Name des Projekts. Wird az configure -d project=<project_name>
verwendet, um einen Standardwert zu konfigurieren.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Bildreferenzinformationen für eine Definition der Computer, die aus diesem Pool erstellt werden. Wird ignoriert, wenn der Parameter devbox-definition-type "Reference" lautet oder nicht angegeben wird. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Name einer Dev Box-Definition im übergeordneten Projekt dieses Pools. Wird ignoriert, wenn der Parameter devbox-definition-type value ist.
Die SKU für Dev Boxes, die aus dem Pool erstellt wurden. Wird ignoriert, wenn der Parameter devbox-definition-type "Reference" lautet oder nicht angegeben wird. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt an, ob der Pool aus einer vorhandenen Dev Box-Definition erstellt oder direkt bereitgestellt wird.
Der Anzeigename des Pools.
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. Wenn nicht angegeben, wird der Speicherort der Ressourcengruppe verwendet.
Die Regionen des verwalteten virtuellen Netzwerks (erforderlich, wenn managedNetworkType verwaltet wird). Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Name einer Netzwerkverbindung im übergeordneten Projekt dieses Pools.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Gibt an, ob Dev Boxes in diesem Pool mit aktivierter Einmaligem Anmelden erstellt werden. Außerdem muss einmaliges Anmelden für den Mandanten aktiviert sein.
Beenden Sie die Verbindung der Konfigurationseinstellungen für Entwicklerfelder, die in diesem Pool erstellt wurden. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Beenden Sie keine Verbindungskonfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt an, ob der Pool ein virtuelles Netzwerk verwendet, das von Microsoft oder einem vom Kunden bereitgestellten Netzwerk verwaltet wird.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az devcenter admin pool delete
Löschen eines Pools
az devcenter admin pool delete [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--project]
[--resource-group]
[--subscription]
[--yes]
Beispiele
Löschen
az devcenter admin pool delete --name "DevPool" --project-name "DevProject" --resource-group "rg1"
Optionale Parameter
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.
Name des Pools.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Der Name des Projekts. Wird az configure -d project=<project_name>
verwendet, um einen Standardwert zu konfigurieren.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Nicht zur Bestätigung auffordern
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az devcenter admin pool list
Auflisten von Pools für ein Projekt.
az devcenter admin pool list --project
--resource-group
[--max-items]
[--next-token]
Beispiele
Liste
az devcenter admin pool list --project-name "DevProject" --resource-group "rg1"
Erforderliche Parameter
Der Name des Projekts. Wird az configure -d project=<project_name>
verwendet, um einen Standardwert zu konfigurieren.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
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.
Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az devcenter admin pool run-health-check
Löst eine Aktualisierung des Poolstatus aus.
az devcenter admin pool run-health-check [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--project]
[--resource-group]
[--subscription]
Beispiele
Integritätsprüfung ausführen
az devcenter admin pool run-health-check --name "DevPool" --project-name "DevProject" --resource-group "rg1"
Optionale Parameter
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.
Name des Pools.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Der Name des Projekts. Wird az configure -d project=<project_name>
verwendet, um einen Standardwert zu konfigurieren.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az devcenter admin pool show
Rufen Sie einen Pool ab.
az devcenter admin pool show [--ids]
[--name]
[--project]
[--resource-group]
[--subscription]
Beispiele
Abrufen
az admin pool show --name "DevPool" --project-name "DevProject" --resource-group "rg1"
Optionale Parameter
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.
Name des Pools.
Der Name des Projekts. Wird az configure -d project=<project_name>
verwendet, um einen Standardwert zu konfigurieren.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az devcenter admin pool update
Aktualisieren eines Pools.
az devcenter admin pool update [--add]
[--devbox-definition-image-reference]
[--devbox-definition-name]
[--devbox-definition-sku]
[--devbox-definition-type {Reference, Value}]
[--display-name]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--local-administrator {Disabled, Enabled}]
[--managed-virtual-network-regions]
[--name]
[--network-connection-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--project]
[--remove]
[--resource-group]
[--set]
[--single-sign-on-status {Disabled, Enabled}]
[--stop-on-disconnect]
[--stop-on-no-connect]
[--subscription]
[--tags]
[--virtual-network-type {Managed, Unmanaged}]
Beispiele
Aktualisieren
az devcenter admin pool update --devbox-definition-name "WebDevBox2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --stop-on-disconnect status="Disabled"
Optionale Parameter
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>
.
Bildreferenzinformationen für eine Definition der Computer, die aus diesem Pool erstellt werden. Wird ignoriert, wenn der Parameter devbox-definition-type "Reference" lautet oder nicht angegeben wird. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Name einer Dev Box-Definition im übergeordneten Projekt dieses Pools. Wird ignoriert, wenn der Parameter devbox-definition-type value ist.
Die SKU für Dev Boxes, die aus dem Pool erstellt wurden. Wird ignoriert, wenn der Parameter devbox-definition-type "Reference" lautet oder nicht angegeben wird. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt an, ob der Pool aus einer vorhandenen Dev Box-Definition erstellt oder direkt bereitgestellt wird.
Der Anzeigename des Pools.
Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.
Gibt an, ob Besitzer von Entwicklungsfeldern in diesem Pool als lokale Administratoren im Entwicklerfeld hinzugefügt werden.
Die Regionen des verwalteten virtuellen Netzwerks (erforderlich, wenn managedNetworkType verwaltet wird). Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Name des Pools.
Name einer Netzwerkverbindung im übergeordneten Projekt dieses Pools.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Der Name des Projekts. Wird az configure -d project=<project_name>
verwendet, um einen Standardwert zu konfigurieren.
Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove>
ODER --remove propertyToRemove
.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>
.
Gibt an, ob Dev Boxes in diesem Pool mit aktivierter Einmaligem Anmelden erstellt werden. Außerdem muss einmaliges Anmelden für den Mandanten aktiviert sein.
Beenden Sie die Verbindung der Konfigurationseinstellungen für Entwicklerfelder, die in diesem Pool erstellt wurden. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Beenden Sie keine Verbindungskonfigurationseinstellungen für Dev Boxes, die in diesem Pool erstellt wurden. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt an, ob der Pool ein virtuelles Netzwerk verwendet, das von Microsoft oder einem vom Kunden bereitgestellten Netzwerk verwaltet wird.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az devcenter admin pool wait
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.
az devcenter admin pool wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--project]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Optionale Parameter
Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.
Abrufintervall in Sekunden.
Name des Pools.
Der Name des Projekts. Wird az configure -d project=<project_name>
verwendet, um einen Standardwert zu konfigurieren.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.