az devcenter admin devbox-definition

Note

Ta dokumentacja jest częścią rozszerzenia devcenter dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az devcenter admin devbox-definition. Dowiedz się więcej o rozszerzeniach.

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ść
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	Properties Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--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ść
Grupa parametrów:	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ść
Grupa parametrów:	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

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

Właściwość	Wartość
Grupa parametrów:	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

Format danych wyjściowych.

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--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ść
Grupa parametrów:	Resource Id Arguments

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

Nazwa definicji pola deweloperskiego.

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	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

Format danych wyjściowych.

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--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ść
Grupa parametrów:	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ść
Grupa parametrów:	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

Format danych wyjściowych.

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--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ść
Grupa parametrów:	Resource Id Arguments

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

Nazwa definicji pola deweloperskiego.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--ids

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	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

Format danych wyjściowych.

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--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ść
Grupa parametrów:	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ść
Grupa parametrów:	Resource Id Arguments

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

Nazwa definicji pola deweloperskiego.

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	Generic Update Arguments
Dopuszczalne wartości:	0, 1, f, false, n, no, t, true, y, yes

--hibernate-support

Właściwość	Wartość
Grupa parametrów:	Properties Arguments
Dopuszczalne wartości:	Disabled, Enabled

--ids

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	Properties Arguments

--remove

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

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	Resource Id Arguments

--tags

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

Właściwość	Wartość
Grupa parametrów:	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

Format danych wyjściowych.

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--created

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

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	Wait Condition Arguments

--deleted

Poczekaj na usunięcie.

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	Resource Id Arguments

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

Nazwa definicji pola deweloperskiego.

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--exists

Zaczekaj, aż zasób istnieje.

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	False

--ids

Właściwość	Wartość
Grupa parametrów:	Resource Id Arguments

--interval

Interwał sondowania w sekundach.

Właściwość	Wartość
Grupa parametrów:	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ść
Grupa parametrów:	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ść
Grupa parametrów:	Resource Id Arguments

--timeout

Maksymalny czas oczekiwania w sekundach.

Właściwość	Wartość
Grupa parametrów:	Wait Condition Arguments
Domyślna wartość:	3600

--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Właściwość	Wartość
Grupa parametrów:	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

Format danych wyjściowych.

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

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij za pomocą

az devcenter admin devbox-definition

Polecenia

az devcenter admin devbox-definition create

Przykłady

Parametry wymagane

Parametry opcjonalne

az devcenter admin devbox-definition delete

Przykłady

Parametry opcjonalne

az devcenter admin devbox-definition list

Przykłady

Parametry wymagane

Parametry opcjonalne

az devcenter admin devbox-definition show

Przykłady

Parametry opcjonalne

az devcenter admin devbox-definition update

Przykłady

Parametry opcjonalne

az devcenter admin devbox-definition wait

Parametry opcjonalne

Sprzężenie zwrotne