Udostępnij za pośrednictwem

az devcenter admin devbox-definition

Note

This reference is part of the devcenter extension for the Azure CLI (version 2.67.0 or higher). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az devcenter admin devbox-definition. Learn more about extensions.

Zarządzanie definicjami pól deweloperskich.

Polecenia

Nazwa Opis Typ Stan
az devcenter admin devbox-definition create

Utwórz definicję pola deweloperskiego.

 Extension ogólna dostępność
az devcenter admin devbox-definition delete

Usuń definicję pola deweloperskiego.

 Extension ogólna dostępność
az devcenter admin devbox-definition list

Wyświetlanie listy definicji pól deweloperskich skonfigurowanych dla centrum deweloperskiego lub projektu.

 Extension ogólna dostępność
az devcenter admin devbox-definition show

Pobierz definicję pola deweloperskiego skonfigurowaną dla centrum deweloperskiego lub projektu.

 Extension ogólna dostępność
az devcenter admin devbox-definition update

Aktualizowanie definicji pola deweloperskiego.

 Extension ogólna dostępność
az devcenter admin devbox-definition wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

 Extension ogólna dostępność

az devcenter admin devbox-definition create

Utwórz definicję pola deweloperskiego.

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]

Przykłady

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"

Parametry wymagane

--dev-center --dev-center-name -d

Nazwa centrum deweloperskiego. Użyj az configure -d dev-center=<dev_center_name>, aby skonfigurować ustawienie domyślne.

--devbox-definition-name --name -n

Nazwa definicji pola deweloperskiego.

--image-reference

Informacje o dokumentacji obrazu. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Parameter group: Properties Arguments
--os-storage-type

Typ magazynu używany dla dysku systemu operacyjnego pól deweloperskich utworzonych przy użyciu tej definicji.

Właściwość Wartość
Parameter group: Properties Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--sku

Jednostka SKU dla pól deweloperskich utworzonych przy użyciu tej definicji. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Parameter group: Properties Arguments

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--hibernate-support

Wskazuje, czy pola deweloperskie utworzone za pomocą tej definicji są w stanie hibernacji. Nie wszystkie obrazy są w stanie obsługiwać hibernacji. Aby dowiedzieć się więcej, zobacz https://aka.ms/devbox/hibernate.

Właściwość Wartość
Parameter group: Properties Arguments
Dopuszczalne wartości: Disabled, Enabled
--location -l

Lokalizacja geograficzna, w której znajduje się zasób. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>. Jeśli nie zostanie określona, zostanie użyta lokalizacja grupy zasobów.

Właściwość Wartość
Parameter group: Body Arguments
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--tags

Resource tags. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Parameter group: Body Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az devcenter admin devbox-definition delete

Usuń definicję pola deweloperskiego.

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]

Przykłady

Delete

az devcenter admin devbox-definition delete --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--dev-center --dev-center-name -d

Nazwa centrum deweloperskiego. Użyj az configure -d dev-center=<dev_center_name>, aby skonfigurować ustawienie domyślne.

Właściwość Wartość
Parameter group: Resource Id Arguments
--devbox-definition-name --name -n

Nazwa definicji pola deweloperskiego.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az devcenter admin devbox-definition list

Wyświetlanie listy definicji pól deweloperskich skonfigurowanych dla centrum deweloperskiego lub projektu.

az devcenter admin devbox-definition list --resource-group
                                          [--dev-center --dev-center-name]
                                          [--max-items]
                                          [--next-token]
                                          [--project --project-name]

Przykłady

Wyświetlanie listy według centrum deweloperów

az devcenter admin devbox-definition list --dev-center-name "Contoso" --resource-group "rg1"

Lista według projektu

az devcenter admin devbox-definition list --project-name "ContosoProject" --resource-group "rg1"

Parametry wymagane

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--dev-center --dev-center-name -d

Nazwa centrum deweloperskiego. Użyj az configure -d dev-center=<dev_center_name>, aby skonfigurować ustawienie domyślne.

--max-items

Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token argumentu kolejnego polecenia.

Właściwość Wartość
Parameter group: Pagination Arguments
--next-token

Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.

Właściwość Wartość
Parameter group: Pagination Arguments
--project --project-name

Nazwa projektu. Użyj az configure -d project=<project_name>, aby skonfigurować ustawienie domyślne.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az devcenter admin devbox-definition show

Pobierz definicję pola deweloperskiego skonfigurowaną dla centrum deweloperskiego lub projektu.

az devcenter admin devbox-definition show [--dev-center --dev-center-name]
                                          [--devbox-definition-name --name]
                                          [--ids]
                                          [--project --project-name]
                                          [--resource-group]
                                          [--subscription]

Przykłady

Pobieranie definicji pola deweloperskiego centrum deweloperskiego

az devcenter admin devbox-definition show --name "WebDevBox" --dev-center-name "Contoso" --resource-group "rg1"

Pobieranie definicji pola deweloperskiego projektu

az devcenter admin devbox-definition show --name "WebDevBox" --project-name "ContosoProject" --resource-group "rg1"

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--dev-center --dev-center-name -d

Nazwa centrum deweloperskiego. Użyj az configure -d dev-center=<dev_center_name>, aby skonfigurować ustawienie domyślne.

Właściwość Wartość
Parameter group: Resource Id Arguments
--devbox-definition-name --name -n

Nazwa definicji pola deweloperskiego.

Właściwość Wartość
Parameter group: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--project --project-name

Nazwa projektu. Użyj az configure -d project=<project_name>, aby skonfigurować ustawienie domyślne.

Właściwość Wartość
Parameter group: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az devcenter admin devbox-definition update

Aktualizowanie definicji pola deweloperskiego.

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]

Przykłady

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"

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Właściwość Wartość
Parameter group: Generic Update Arguments
--dev-center --dev-center-name -d

Nazwa centrum deweloperskiego. Użyj az configure -d dev-center=<dev_center_name>, aby skonfigurować ustawienie domyślne.

Właściwość Wartość
Parameter group: Resource Id Arguments
--devbox-definition-name --name -n

Nazwa definicji pola deweloperskiego.

Właściwość Wartość
Parameter group: Resource Id Arguments
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Właściwość Wartość
Parameter group: Generic Update Arguments
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--hibernate-support

Wskazuje, czy pola deweloperskie utworzone za pomocą tej definicji są w stanie hibernacji. Nie wszystkie obrazy są w stanie obsługiwać hibernacji. Aby dowiedzieć się więcej, zobacz https://aka.ms/devbox/hibernate.

Właściwość Wartość
Parameter group: Properties Arguments
Dopuszczalne wartości: Disabled, Enabled
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--image-reference

Informacje o dokumentacji obrazu. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Parameter group: Properties Arguments
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

Właściwość Wartość
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--os-storage-type

Typ magazynu używany dla dysku systemu operacyjnego pól deweloperskich utworzonych przy użyciu tej definicji.

Właściwość Wartość
Parameter group: Properties Arguments
--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Właściwość Wartość
Parameter group: Generic Update Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Właściwość Wartość
Parameter group: Generic Update Arguments
--sku

Jednostka SKU dla pól deweloperskich utworzonych przy użyciu tej definicji. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Parameter group: Properties Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
--tags

Resource tags. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Parameter group: Body Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az devcenter admin devbox-definition wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku.

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]

Parametry opcjonalne

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Właściwość Wartość
Parameter group: Wait Condition Arguments
--deleted

Poczekaj na usunięcie.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
--dev-center --dev-center-name -d

Nazwa centrum deweloperskiego. Użyj az configure -d dev-center=<dev_center_name>, aby skonfigurować ustawienie domyślne.

Właściwość Wartość
Parameter group: Resource Id Arguments
--devbox-definition-name --name -n

Nazwa definicji pola deweloperskiego.

Właściwość Wartość
Parameter group: Resource Id Arguments
--exists

Zaczekaj, aż zasób istnieje.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Parameter group: Resource Id Arguments
--interval

Interwał sondowania w sekundach.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: 30
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Parameter group: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Parameter group: Resource Id Arguments
--timeout

Maksymalny czas oczekiwania w sekundach.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Właściwość Wartość
Parameter group: Wait Condition Arguments
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Output format.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False