Dela via

az devcenter admin pool

  • Referens

Kommentar

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

Hantera pooler.

Kommandon

Name Description Typ Status
az devcenter admin pool create

Skapa en pool.

 Anknytning Allmän tillgänglighet
az devcenter admin pool delete

Ta bort en pool.

 Anknytning Allmän tillgänglighet
az devcenter admin pool list

Lista pooler för ett projekt.

 Anknytning Allmän tillgänglighet
az devcenter admin pool run-health-check

Utlöser en uppdatering av poolstatusen.

 Anknytning Allmän tillgänglighet
az devcenter admin pool show

Hämta en pool.

 Anknytning Allmän tillgänglighet
az devcenter admin pool update

Uppdatera en pool.

 Anknytning Allmän tillgänglighet
az devcenter admin pool wait

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

 Anknytning Allmän tillgänglighet

az devcenter admin pool create

Skapa en 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}]

Exempel

Skapa pool med ohanterat nätverk

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

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

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

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

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

Delete

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

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

Exempel

List

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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 argumentet 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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

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

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

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

Exempel

Hämta

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

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

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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 prenumerationen. Du kan konfigurera standardprenumerationen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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.

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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