az devcenter admin pool

Anteckning

Den här referensen är en del av devcenter--tillägget för Azure CLI (version 2.67.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az devcenter admin pool kommando. Läs mer om tillägg.

Hantera pooler.

Kommandon

Name Description Typ Status
az devcenter admin pool create

Skapa en pool.

Förlängning GA
az devcenter admin pool delete

Ta bort en pool.

Förlängning GA
az devcenter admin pool list

Lista pooler för ett projekt.

Förlängning GA
az devcenter admin pool run-health-check

Utlöser en uppdatering av poolstatusen.

Förlängning GA
az devcenter admin pool show

Hämta en pool.

Förlängning GA
az devcenter admin pool update

Uppdatera en pool.

Förlängning GA
az devcenter admin pool wait

Placera CLI i vänteläge tills ett villkor uppfylls.

Förlängning GA

az devcenter admin pool create

Skapa en pool.

Azure CLI
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}]

Exempel

Skapa pool med ohanterat nätverk

Azure CLI
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"

Skapa pool med hanterat nätverk

Azure CLI
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"

Skapa en pool med stopp vid frånkoppling aktiverat

Azure CLI
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"

Skapa pool med avbildningsdefinition

Azure CLI
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"

Obligatoriska parametrar

--local-administrator

Anger om ägare av dev-rutor i den här poolen läggs till som lokala administratörer i utvecklingsrutan.

Godkända värden: Disabled, Enabled
--name --pool-name -n

Namnet på poolen.

--project --project-name

Namnet på projektet. Använd az configure -d project=<project_name> för att konfigurera ett standardvärde.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--devbox-definition-image-reference -i
Förhandsgranskning

Bildreferensinformation för en definition av datorerna som skapas från den här poolen. Ignoreras om parametern devbox-definition-type är Referens eller inte tillhandahålls. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--devbox-definition-name -d

Namnet på en dev box-definition i det överordnade projektet för den här poolen. Ignoreras om parametern devbox-definition-type är Value.

--devbox-definition-sku -s
Förhandsgranskning

SKU:n för dev-rutor som skapats från poolen. Ignoreras om parametern devbox-definition-type är Referens eller inte tillhandahålls. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--devbox-definition-type -t

Anger om poolen skapas från en befintlig Dev Box-definition eller om en skapas direkt.

Godkända värden: Reference, Value
--display-name

Visningsnamnet för poolen.

--location -l

Den geo-plats där resursen finns. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>. När det inte anges används platsen för resursgruppen.

--managed-virtual-network-regions -m

Regionerna i det hanterade virtuella nätverket (krävs när managedNetworkType hanteras). Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--network-connection-name -c

Namnet på en nätverksanslutning i det överordnade projektet för den här poolen.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--single-sign-on-status

Anger om Dev Boxes i den här poolen skapas med enkel inloggning aktiverat. Kräver också att enkel inloggning aktiveras på klientorganisationen.

Godkända värden: Disabled, Enabled
--stop-on-disconnect

Stoppa frånkopplingskonfigurationsinställningarna för dev-rutor som skapats i den här poolen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--stop-on-no-connect
Förhandsgranskning

Stoppa inga anslutningskonfigurationsinställningar för Dev Boxes som skapats i den här poolen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--tags

Resurstaggar. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--virtual-network-type

Anger om poolen använder ett virtuellt nätverk som hanteras av Microsoft eller ett nätverk som tillhandahålls av kunden.

Godkända värden: Managed, Unmanaged
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az devcenter admin pool delete

Ta bort en pool.

Azure CLI
az devcenter admin pool delete [--ids]
                               [--name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--project]
                               [--resource-group]
                               [--subscription]
                               [--yes]

Exempel

Ta bort

Azure CLI
az devcenter admin pool delete --name "DevPool" --project-name "DevProject" --resource-group "rg1"

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --pool-name -n

Namnet på poolen.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Namnet på projektet. Använd az configure -d project=<project_name> för att konfigurera ett standardvärde.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az devcenter admin pool list

Lista pooler för ett projekt.

Azure CLI
az devcenter admin pool list --project
                             --resource-group
                             [--max-items]
                             [--next-token]

Exempel

Lista

Azure CLI
az devcenter admin pool list --project-name "DevProject" --resource-group "rg1"

Obligatoriska parametrar

--project --project-name

Namnet på projektet. Använd az configure -d project=<project_name> för att konfigurera ett standardvärde.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--max-items

Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argument för ett efterföljande kommando.

--next-token

Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az devcenter admin pool run-health-check

Utlöser en uppdatering av poolstatusen.

Azure CLI
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]

Exempel

Kör hälsokontroll

Azure CLI
az devcenter admin pool run-health-check --name "DevPool" --project-name "DevProject" --resource-group "rg1"

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --pool-name -n

Namnet på poolen.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Namnet på projektet. Använd az configure -d project=<project_name> för att konfigurera ett standardvärde.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az devcenter admin pool show

Hämta en pool.

Azure CLI
az devcenter admin pool show [--ids]
                             [--name]
                             [--project]
                             [--resource-group]
                             [--subscription]

Exempel

Azure CLI
az admin pool show --name "DevPool" --project-name "DevProject" --resource-group "rg1"

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name --pool-name -n

Namnet på poolen.

--project --project-name

Namnet på projektet. Använd az configure -d project=<project_name> för att konfigurera ett standardvärde.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az devcenter admin pool update

Uppdatera en pool.

Azure CLI
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}]

Exempel

Uppdatera

Azure CLI
az devcenter admin pool update --devbox-definition-name "WebDevBox2" --pool-name "DevPool" --project-name "DevProject" --resource-group "rg1" --stop-on-disconnect status="Disabled"

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

--devbox-definition-image-reference -i
Förhandsgranskning

Bildreferensinformation för en definition av datorerna som skapas från den här poolen. Ignoreras om parametern devbox-definition-type är Referens eller inte tillhandahålls. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--devbox-definition-name -d

Namnet på en dev box-definition i det överordnade projektet för den här poolen. Ignoreras om parametern devbox-definition-type är Value.

--devbox-definition-sku -s
Förhandsgranskning

SKU:n för dev-rutor som skapats från poolen. Ignoreras om parametern devbox-definition-type är Referens eller inte tillhandahålls. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--devbox-definition-type -t

Anger om poolen skapas från en befintlig Dev Box-definition eller om en skapas direkt.

Godkända värden: Reference, Value
--display-name

Visningsnamnet för poolen.

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--local-administrator

Anger om ägare av dev-rutor i den här poolen läggs till som lokala administratörer i utvecklingsrutan.

Godkända värden: Disabled, Enabled
--managed-virtual-network-regions -m

Regionerna i det hanterade virtuella nätverket (krävs när managedNetworkType hanteras). Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--name --pool-name -n

Namnet på poolen.

--network-connection-name -c

Namnet på en nätverksanslutning i det överordnade projektet för den här poolen.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--project --project-name

Namnet på projektet. Använd az configure -d project=<project_name> för att konfigurera ett standardvärde.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

--single-sign-on-status

Anger om Dev Boxes i den här poolen skapas med enkel inloggning aktiverat. Kräver också att enkel inloggning aktiveras på klientorganisationen.

Godkända värden: Disabled, Enabled
--stop-on-disconnect

Stoppa frånkopplingskonfigurationsinställningarna för dev-rutor som skapats i den här poolen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--stop-on-no-connect
Förhandsgranskning

Stoppa inga anslutningskonfigurationsinställningar för Dev Boxes som skapats i den här poolen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--tags

Resurstaggar. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--virtual-network-type

Anger om poolen använder ett virtuellt nätverk som hanteras av Microsoft eller ett nätverk som tillhandahålls av kunden.

Godkända värden: Managed, Unmanaged
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az devcenter admin pool wait

Placera CLI i vänteläge tills ett villkor uppfylls.

Azure CLI
az devcenter admin pool wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--ids]
                             [--interval]
                             [--name]
                             [--project]
                             [--resource-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

Standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

Standardvärde: False
--exists

Vänta tills resursen finns.

Standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--interval

Avsökningsintervall i sekunder.

Standardvärde: 30
--name --pool-name -n

Namnet på poolen.

--project --project-name

Namnet på projektet. Använd az configure -d project=<project_name> för att konfigurera ett standardvärde.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--timeout

Maximal väntetid i sekunder.

Standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.