az devcenter admin pool

Riferimento

Nota

Questo riferimento fa parte dell'estensione devcenter per l'interfaccia della riga di comando di Azure (versione 2.67.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az devcenter admin pool. Altre sulle estensioni.

Gestire i pool.

Comandi

Nome	Descrizione	Tipo	Status
az devcenter admin pool create	Creare un pool.	Estensione	GA
az devcenter admin pool delete	Eliminare un pool.	Estensione	GA
az devcenter admin pool list	Elencare i pool per un progetto.	Estensione	GA
az devcenter admin pool run-health-check	Attiva un aggiornamento dello stato del pool.	Estensione	GA
az devcenter admin pool show	Ottenere un pool.	Estensione	GA
az devcenter admin pool update	Aggiornare un pool.	Estensione	GA
az devcenter admin pool wait	Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.	Estensione	GA

az devcenter admin pool create

Creare un 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}]

Esempio

Creare un pool usando una rete non gestita

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"

Creare un pool usando la rete gestita

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"

Creare un pool con arresto in caso di disconnessione abilitata

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"

Creare un pool usando la definizione dell'immagine

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"

Parametri necessari

--local-administrator

Indica se i proprietari delle caselle di sviluppo in questo pool vengono aggiunti come amministratori locali nella casella di sviluppo.

Valori accettati: Disabled, Enabled

--name --pool-name -n

Nome del pool.

--project --project-name

Nome del progetto. Usare az configure -d project=<project_name> per configurare un valore predefinito.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri facoltativi

--devbox-definition-image-reference -i

Anteprima

Informazioni di riferimento sulle immagini per una definizione dei computer creati da questo pool. Verrà ignorato se il parametro devbox-definition-type è Reference o non viene specificato. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--devbox-definition-name -d

Nome di una definizione della casella di sviluppo nel progetto padre di questo pool. Verrà ignorato se il parametro devbox-definition-type è Value.

--devbox-definition-sku -s

Anteprima

SKU per Dev Boxes creato dal pool. Verrà ignorato se il parametro devbox-definition-type è Reference o non viene specificato. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--devbox-definition-type -t

Indica se il pool viene creato da una definizione di Dev Box esistente o se ne viene fornita direttamente una.

Valori accettati: Reference, Value

--display-name

Nome visualizzato del pool.

--location -l

Posizione geografica in cui risiede la risorsa. Valori da: az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>. Se non specificato, verrà usata la posizione del gruppo di risorse.

--managed-virtual-network-regions -m

Aree della rete virtuale gestita (obbligatoria quando managedNetworkType è gestito). Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--network-connection-name -c

Nome di una connessione di rete nel progetto padre di questo pool.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--single-sign-on-status

Indica se Dev Boxes in questo pool vengono creati con l'accesso Single Sign-On abilitato. Richiede anche che l'accesso Single Sign-On sia abilitato nel tenant.

Valori accettati: Disabled, Enabled

--stop-on-disconnect

Arresta in caso di disconnessione delle impostazioni di configurazione per le caselle di sviluppo create in questo pool. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--stop-on-no-connect

Anteprima

Arresta senza impostazioni di configurazione di connessione per Dev Boxes creati in questo pool. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--tags

Tag di risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--virtual-network-type

Indica se il pool usa una rete virtuale gestita da Microsoft o da una rete fornita dal cliente.

Valori accettati: Managed, Unmanaged

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

az devcenter admin pool delete

Eliminare un 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]

Esempio

Cancellare

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

Parametri facoltativi

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--name --pool-name -n

Nome del pool.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--project --project-name

Nome del progetto. Usare az configure -d project=<project_name> per configurare un valore predefinito.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--yes -y

Non richiedere conferma.

Valore predefinito: False

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

az devcenter admin pool list

Elencare i pool per un progetto.

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

Esempio

Lista

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

Parametri necessari

--project --project-name

Nome del progetto. Usare az configure -d project=<project_name> per configurare un valore predefinito.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

Parametri facoltativi

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token in --next-token argomento di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

az devcenter admin pool run-health-check

Attiva un aggiornamento dello stato del pool.

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]

Esempio

Eseguire il controllo integrità

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

Parametri facoltativi

--ids

--name --pool-name -n

Nome del pool.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--project --project-name

Nome del progetto. Usare az configure -d project=<project_name> per configurare un valore predefinito.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

az devcenter admin pool show

Ottenere un pool.

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

Esempio

Ottieni

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

Parametri facoltativi

--ids

--name --pool-name -n

Nome del pool.

--project --project-name

Nome del progetto. Usare az configure -d project=<project_name> per configurare un valore predefinito.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

az devcenter admin pool update

Aggiornare un 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}]

Esempio

Aggiornare

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

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

--devbox-definition-image-reference -i

Anteprima

--devbox-definition-name -d

Nome di una definizione della casella di sviluppo nel progetto padre di questo pool. Verrà ignorato se il parametro devbox-definition-type è Value.

--devbox-definition-sku -s

Anteprima

--devbox-definition-type -t

Indica se il pool viene creato da una definizione di Dev Box esistente o se ne viene fornita direttamente una.

Valori accettati: Reference, Value

--display-name

Nome visualizzato del pool.

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--ids

--local-administrator

Indica se i proprietari delle caselle di sviluppo in questo pool vengono aggiunti come amministratori locali nella casella di sviluppo.

Valori accettati: Disabled, Enabled

--managed-virtual-network-regions -m

Aree della rete virtuale gestita (obbligatoria quando managedNetworkType è gestito). Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--name --pool-name -n

Nome del pool.

--network-connection-name -c

Nome di una connessione di rete nel progetto padre di questo pool.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes

--project --project-name

Nome del progetto. Usare az configure -d project=<project_name> per configurare un valore predefinito.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

--single-sign-on-status

Indica se Dev Boxes in questo pool vengono creati con l'accesso Single Sign-On abilitato. Richiede anche che l'accesso Single Sign-On sia abilitato nel tenant.

Valori accettati: Disabled, Enabled

--stop-on-disconnect

--stop-on-no-connect

Anteprima

Arresta senza impostazioni di configurazione di connessione per Dev Boxes creati in questo pool. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Tag di risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--virtual-network-type

Indica se il pool usa una rete virtuale gestita da Microsoft o da una rete fornita dal cliente.

Valori accettati: Managed, Unmanaged

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

az devcenter admin pool wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

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

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False

--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False

--exists

Attendere che la risorsa esista.

Valore predefinito: False

--ids

--interval

Intervallo di polling in secondi.

Valore predefinito: 30

--name --pool-name -n

Nome del pool.

--project --project-name

Nome del progetto. Usare az configure -d project=<project_name> per configurare un valore predefinito.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600

--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

Valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.

Condividi tramite

az devcenter admin pool

Comandi

az devcenter admin pool create

Esempio

Parametri necessari

Parametri facoltativi

az devcenter admin pool delete

Esempio

Parametri facoltativi

az devcenter admin pool list

Esempio

Parametri necessari

Parametri facoltativi

az devcenter admin pool run-health-check

Esempio

Parametri facoltativi

az devcenter admin pool show

Esempio

Parametri facoltativi

az devcenter admin pool update

Esempio

Parametri facoltativi

az devcenter admin pool wait

Parametri facoltativi

Risorse aggiuntive