az devcenter admin devbox-definition
Note
Tento odkaz je součástí rozšíření devcenter pro Azure CLI (verze 2.67.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az devcenter admin devbox-definition. Přečtěte si další informace o rozšířeních.
Správa definic vývojového pole
Příkazy
| Name | Description | Typ | Stav |
|---|---|---|---|
| az devcenter admin devbox-definition create |
Vytvořte definici vývojového pole. |
Extension | GA |
| az devcenter admin devbox-definition delete |
Odstraňte definici vývojového pole. |
Extension | GA |
| az devcenter admin devbox-definition list |
Výpis definic vývojových polí nakonfigurovaných pro vývojové centrum nebo projekt |
Extension | GA |
| az devcenter admin devbox-definition show |
Získejte definici vývojového pole nakonfigurovanou pro vývojové centrum nebo projekt. |
Extension | GA |
| az devcenter admin devbox-definition update |
Aktualizujte definici vývojového pole. |
Extension | GA |
| az devcenter admin devbox-definition wait |
Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka. |
Extension | GA |
az devcenter admin devbox-definition create
Vytvořte definici vývojového pole.
az devcenter admin devbox-definition create --dev-center --dev-center-name
--devbox-definition-name --name
--image-reference
--os-storage-type
--resource-group
--sku
[--hibernate-support {Disabled, Enabled}]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--tags]
Příklady
Create
az devcenter admin devbox-definition create --location "eastus" --image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.DevCenter/devcenters/Contoso/galleries/contosogallery/images/exampleImage/version/1.0.0" --os-storage-type "ssd_1024gb" --sku name="general_a_8c32gb_v1" --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
Povinné parametry
Název vývojového centra. Ke konfiguraci výchozího nastavení použijte az configure -d dev-center=<dev_center_name>.
Název definice vývojového pole.
Referenční informace k obrázku Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Typ úložiště používaný pro disk operačního systému vývojových polí vytvořených pomocí této definice.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
Skladová položka pro vývojová pole vytvořená pomocí této definice. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Určuje, jestli jsou vývojová pole vytvořená s touto definicí schopná hibernace. Ne všechny image jsou schopné podporovat hibernaci. Další informace najdete v tématu https://aka.ms/devbox/hibernate.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
| Přípustné hodnoty: | Disabled, Enabled |
Geografické umístění, ve kterém se nachází zdroj. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location> Pokud není zadáno, použije se umístění skupiny prostředků.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Body Arguments |
Nečekejte na dokončení dlouhotrvající operace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | 0, 1, f, false, n, no, t, true, y, yes |
Značky prostředků Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Body Arguments |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az devcenter admin devbox-definition delete
Odstraňte definici vývojového pole.
az devcenter admin devbox-definition delete [--dev-center --dev-center-name]
[--devbox-definition-name --name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
Příklady
Delete
az devcenter admin devbox-definition delete --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Název vývojového centra. Ke konfiguraci výchozího nastavení použijte az configure -d dev-center=<dev_center_name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název definice vývojového pole.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Nečekejte na dokončení dlouhotrvající operace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | 0, 1, f, false, n, no, t, true, y, yes |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Nevyzývejte k potvrzení.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az devcenter admin devbox-definition list
Výpis definic vývojových polí nakonfigurovaných pro vývojové centrum nebo projekt
az devcenter admin devbox-definition list --resource-group
[--dev-center --dev-center-name]
[--max-items]
[--next-token]
[--project --project-name]
Příklady
Seznam podle dev center
az devcenter admin devbox-definition list --dev-center-name "Contoso" --resource-group "rg1"
Seznam podle projektu
az devcenter admin devbox-definition list --project-name "ContosoProject" --resource-group "rg1"
Povinné parametry
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Název vývojového centra. Ke konfiguraci výchozího nastavení použijte az configure -d dev-center=<dev_center_name>.
Celkový počet položek, které se mají vrátit ve výstupu příkazu Pokud je celkový počet dostupných položek větší než zadaná hodnota, zobrazí se ve výstupu příkazu token. Pokud chcete pokračovat ve stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Pagination Arguments |
Token určující, kde se má stránkování spustit. Toto je hodnota tokenu z dříve zkrácené odpovědi.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Pagination Arguments |
Název projektu. Ke konfiguraci výchozího nastavení použijte az configure -d project=<project_name>.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az devcenter admin devbox-definition show
Získejte definici vývojového pole nakonfigurovanou pro vývojové centrum nebo projekt.
az devcenter admin devbox-definition show [--dev-center --dev-center-name]
[--devbox-definition-name --name]
[--ids]
[--project --project-name]
[--resource-group]
[--subscription]
Příklady
Získání definice vývojového pole dev center
az devcenter admin devbox-definition show --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
Získání definice vývojového pole projektu
az devcenter admin devbox-definition show --name "WebDevBox" --project-name "ContosoProject" --resource-group "rg1"
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Název vývojového centra. Ke konfiguraci výchozího nastavení použijte az configure -d dev-center=<dev_center_name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název definice vývojového pole.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název projektu. Ke konfiguraci výchozího nastavení použijte az configure -d project=<project_name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az devcenter admin devbox-definition update
Aktualizujte definici vývojového pole.
az devcenter admin devbox-definition update [--add]
[--dev-center --dev-center-name]
[--devbox-definition-name --name]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--hibernate-support {Disabled, Enabled}]
[--ids]
[--image-reference]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--os-storage-type]
[--remove]
[--resource-group]
[--set]
[--sku]
[--subscription]
[--tags]
Příklady
Update
az devcenter admin devbox-definition update --image-reference id="/subscriptions/0ac520ee-14c0-480f-b6c9-0a90c58ffff/resourceGroups/Example/providers/Microsoft.DevCenter/devcenters/Contoso/galleries/contosogallery/images/exampleImage/version/2.0.0" --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Generic Update Arguments |
Název vývojového centra. Ke konfiguraci výchozího nastavení použijte az configure -d dev-center=<dev_center_name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název definice vývojového pole.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Generic Update Arguments |
| Přípustné hodnoty: | 0, 1, f, false, n, no, t, true, y, yes |
Určuje, jestli jsou vývojová pole vytvořená s touto definicí schopná hibernace. Ne všechny image jsou schopné podporovat hibernaci. Další informace najdete v tématu https://aka.ms/devbox/hibernate.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
| Přípustné hodnoty: | Disabled, Enabled |
Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Referenční informace k obrázku Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Nečekejte na dokončení dlouhotrvající operace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | 0, 1, f, false, n, no, t, true, y, yes |
Typ úložiště používaný pro disk operačního systému vývojových polí vytvořených pomocí této definice.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Generic Update Arguments |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Generic Update Arguments |
Skladová položka pro vývojová pole vytvořená pomocí této definice. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Značky prostředků Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Body Arguments |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
az devcenter admin devbox-definition wait
Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.
az devcenter admin devbox-definition wait [--created]
[--custom]
[--deleted]
[--dev-center --dev-center-name]
[--devbox-definition-name --name]
[--exists]
[--ids]
[--interval]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Volitelné parametry
Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.
Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | False |
Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
Počkejte na odstranění.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | False |
Název vývojového centra. Ke konfiguraci výchozího nastavení použijte az configure -d dev-center=<dev_center_name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název definice vývojového pole.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Počkejte, až prostředek existuje.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | False |
Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Interval dotazování v sekundách
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | 30 |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Maximální čekání v sekundách.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | 3600 |
Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | False |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |