az sig

參考

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。安裝每個擴充功能以受益於其擴充功能。深入了解擴充功能。

管理共用映像庫。

命令

名稱	Description	類型	狀態
az sig create	建立共用映像庫。	核心	GA
az sig create (image-gallery 擴充功能)	建立共用映像庫。	副檔名	GA
az sig delete	刪除共用映像庫。	核心	GA
az sig gallery-application	管理資源庫應用程式。	核心	GA
az sig gallery-application create	建立資源庫應用程式定義。	核心	GA
az sig gallery-application delete	刪除資源庫應用程式。	核心	GA
az sig gallery-application list	列出資源庫中的資源庫應用程式定義。	核心	GA
az sig gallery-application show	取得資源庫應用程式定義的相關信息。	核心	GA
az sig gallery-application update	更新資源庫應用程式定義。	核心	GA
az sig gallery-application version	管理資源庫應用程式版本。	核心	GA
az sig gallery-application version create	建立資源庫應用程式版本。	核心	GA
az sig gallery-application version delete	刪除資源庫應用程式版本。	核心	GA
az sig gallery-application version list	列出資源庫應用程式版本。	核心	GA
az sig gallery-application version show	取得資源庫應用程式版本的相關信息。	核心	GA
az sig gallery-application version update	更新資源庫應用程式版本。	核心	GA
az sig gallery-application version wait	將 CLI 置於等候狀態，直到符合條件為止。	核心	GA
az sig gallery-application wait	將 CLI 置於等候狀態，直到符合 sig gallery-application 的條件為止。	核心	GA
az sig image-definition	使用 VM 管理共用資源庫映像。	核心和擴充功能	GA
az sig image-definition create	建立資源庫映像定義。	核心	GA
az sig image-definition delete	刪除資源庫映像。	核心	GA
az sig image-definition list	列出資源庫中的圖庫映像定義。	核心	GA
az sig image-definition list-community	列出資源庫社群中的 VM 映像定義。	核心	GA
az sig image-definition list-community (image-gallery 擴充功能)	列出資源庫社群中的 VM 映像定義（預覽版）。	副檔名	實驗
az sig image-definition list-shared	列出直接與您的訂用帳戶或租用戶共享的資源庫中的 VM 映像定義。	核心	GA
az sig image-definition show	取得資源庫映像定義的相關信息。	核心	GA
az sig image-definition show-community	取得社群資源庫映像。	核心	GA
az sig image-definition show-community (image-gallery 擴充功能)	在資源庫社群中取得影像（預覽版）。	副檔名	實驗
az sig image-definition show-shared	取得共享資源庫映像。	核心	GA
az sig image-definition update	更新 VM 映像定義。	核心	GA
az sig image-definition wait	將 CLI 置於等候狀態，直到符合條件為止。	核心	GA
az sig image-version	使用 VM 管理共用資源庫映像版本。	核心和擴充功能	GA
az sig image-version create	建立新的映像版本。	核心	GA
az sig image-version delete	刪除資源庫映像版本。	核心	GA
az sig image-version list	列出資源庫映像定義中的資源庫映像版本。	核心	GA
az sig image-version list-community	列出資源庫社群中的 VM 映像版本。	核心	GA
az sig image-version list-community (image-gallery 擴充功能)	列出資源庫社群中的 VM 映像版本（預覽版）。	副檔名	實驗
az sig image-version list-shared	列出直接與您的訂用帳戶或租用戶共用的資源庫中的 VM 映射版本。	核心	GA
az sig image-version show	擷取資源庫映像版本的相關信息。	核心	GA
az sig image-version show-community	取得社群資源庫映像版本。	核心	GA
az sig image-version show-community (image-gallery 擴充功能)	在資源庫社群中取得映像版本（預覽版）。	副檔名	實驗
az sig image-version show-shared	在直接與您的訂用帳戶或租用戶共享的資源庫中取得映像版本。	核心	GA
az sig image-version undelete	還原虛刪除的映像版本。	核心	預覽
az sig image-version update	更新共用映像版本。	核心	GA
az sig image-version wait	等候映像版本相關作業。	核心	GA
az sig list	列出資源群組底下的資源庫。	核心	GA
az sig list-community	列出直接與您的訂用帳戶或租用戶共用的所有社群資源庫。	核心	GA
az sig list-shared	列出所有直接與您訂用帳戶或租用戶共用的共享資源庫。	核心	GA
az sig share	管理資源庫共用配置檔。	核心和擴充功能	GA
az sig share add	與訂用帳戶和租用戶共享資源庫。	核心	GA
az sig share enable-community	允許將資源庫共用給社群。	核心	GA
az sig share enable-community (image-gallery 擴充功能)	允許將資源庫共用給社群。	副檔名	GA
az sig share remove	停止與訂用帳戶或租用戶共享資源庫。	核心	GA
az sig share reset	停用資源庫與訂用帳戶或租用戶共用。	核心	GA
az sig share wait	將 CLI 置於等候狀態，直到符合共用資源庫的條件為止。	核心	GA
az sig show	擷取共用映像庫的相關信息。	核心	GA
az sig show-community	依資源庫公用名稱取得社群資源庫。	核心	GA
az sig show-community (image-gallery 擴充功能)	取得已是社群的圖庫（預覽版）。	副檔名	實驗
az sig show-shared	取得已直接共用至訂用帳戶或租用戶的資源庫。	核心	GA
az sig update	更新共用映像庫。	核心	GA

az sig create

建立共用映像庫。

az sig create --gallery-name
              --resource-group
              [--description]
              [--eula]
              [--location]
              [--permissions {Community, Groups, Private}]
              [--public-name-prefix]
              [--publisher-email]
              [--publisher-uri]
              [--tags]

範例

建立共用映像庫

az sig create --resource-group MyResourceGroup --gallery-name MyGallery

必要參數

--gallery-name -r

資源庫名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--description

資源庫的描述。

--eula

社群資源庫發行者 eula。

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--permissions

這個屬性可讓您指定共用資源庫的許可權。

接受的值: Community, Groups, Private

--public-name-prefix

社群資源庫公用名稱前置詞。

--publisher-email

社群資源庫發行者連絡電子郵件。

--publisher-uri

社群資源庫發行者 URI。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用「清除現有的標記」。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig create (image-gallery 擴充功能)

建立共用映像庫。

az sig create --gallery-name
              --resource-group
              [--description]
              [--eula]
              [--location]
              [--permissions {Community, Groups, Private}]
              [--public-name-prefix]
              [--publisher-email]
              [--publisher-uri]
              [--soft-delete {false, true}]
              [--tags]

範例

建立共用映像庫

az sig create --resource-group MyResourceGroup --gallery-name MyGallery

必要參數

--gallery-name -r

資源庫名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--description

資源庫的描述。

--eula

社群資源庫許可協議和隱私聲明。

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--permissions

實驗

這個屬性可讓您指定共用資源庫的許可權。

接受的值: Community, Groups, Private

--public-name-prefix

社群資源庫公用名稱前置詞。

--publisher-email

社群資源庫發行者連絡電子郵件。

--publisher-uri

社群資源庫發行者 URI。

--soft-delete

預覽

針對此資源庫中的資源啟用虛刪除功能，以在保留時間內復原資源。

接受的值: false, true

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用「清除現有的標記」。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig delete

刪除共用映像庫。

az sig delete [--gallery-name]
              [--ids]
              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
              [--resource-group]
              [--subscription]

選擇性參數

--gallery-name -r

要刪除之共用映像庫的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。您應該提供 --ids 或其他「資源識別碼」引數。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig list

列出資源群組底下的資源庫。

az sig list [--resource-group]

選擇性參數

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig list-community

列出直接與您的訂用帳戶或租用戶共用的所有社群資源庫。

az sig list-community [--location]
                      [--marker]
                      [--show-next-marker]

範例

列出在指定位置直接共用至您訂用帳戶的社群資源庫

az sig list-community --location myLocation

根據下一個標記，列出直接與您租用戶共用的分頁社群資源庫

az sig list-community --location myLocation --marker nextMarker

選擇性參數

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--marker

字串值，識別要隨著下一個清單作業傳回之容器清單的部分。如果清單作業未傳回剩餘的所有容器，則此作業會傳回響應主體內的 NextMarker 值，以與目前頁面一起列出。如果指定，這個產生器會從前一個產生器停止的點開始傳回結果。

--show-next-marker

指定時，在結果中顯示 nextMarker。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig list-shared

列出所有直接與您訂用帳戶或租用戶共用的共享資源庫。

az sig list-shared --location
                   [--shared-to {tenant}]

範例

列出在指定位置直接共用至訂用帳戶的共享資源庫

az sig list-shared --location myLocation

列出在指定位置中直接共用給租用戶的共享資源庫

az sig list-shared --location myLocation --shared-to tenant

必要參數

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

選擇性參數

--shared-to

查詢參數，決定執行清單作業時要擷取的共用資源庫。如果未指定，請依訂用帳戶標識碼列出。

接受的值: tenant

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig show

擷取共用映像庫的相關信息。

az sig show [--gallery-name]
            [--ids]
            [--resource-group]
            [--select]
            [--sharing-groups]
            [--subscription]

選擇性參數

--gallery-name -r

資源庫名稱。

--ids

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--select

要套用至作業的選取表達式。

--sharing-groups

展開查詢選項以查詢共用資源庫群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig show-community

依資源庫公用名稱取得社群資源庫。

az sig show-community [--ids]
                      [--location]
                      [--name]
                      [--subscription]

選擇性參數

--ids

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--name --public-gallery-name -n

社群資源庫的公用名稱。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig show-community (image-gallery 擴充功能)

實驗

此命令是實驗性且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

取得已是社群的圖庫（預覽版）。

取得已是社群的資源庫（私人預覽功能，請透過電子郵件 sigpmdev@microsoft.com 連絡社群映射庫小組，以註冊預覽版，如果您有興趣使用此功能）。

az sig show-community [--ids]
                      [--location]
                      [--public-gallery-name]
                      [--subscription]

範例

取得已在指定位置中的社群資源庫。

az sig show-community --public-gallery-name publicGalleryName --location myLocation

選擇性參數

--ids

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--public-gallery-name

社群資源庫的公用名稱。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig show-shared

取得已直接共用至訂用帳戶或租用戶的資源庫。

az sig show-shared [--gallery-unique-name]
                   [--ids]
                   [--location]
                   [--subscription]

範例

取得資源庫，該資源庫已直接共用至指定位置中的訂用帳戶或租使用者。

az sig show-shared --gallery-unique-name MyGalleryUniqueName --location MyLocation

選擇性參數

--gallery-unique-name --name -n

共用資源庫的唯一名稱。

--ids

--location -l

位置。值的來源：az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az sig update

更新共用映像庫。

az sig update --gallery-name
              --resource-group
              [--add]
              [--eula]
              [--force-string]
              [--permissions {Community, Groups, Private}]
              [--public-name-prefix]
              [--publisher-email]
              [--publisher-uri]
              [--remove]
              [--select]
              [--set]

範例

啟用資源庫共用至訂用帳戶或租使用者

az sig update --resource-group myResourceGroup --gallery-name myGallery \
--permissions groups

將資源庫從私人更新為社群

az sig update -g myResourceGroup --gallery-name myGallery --permissions Community \
--publisher-uri myPublisherUri --publisher-email myPublisherEmail \
--eula myEula --public-name-prefix myPublicNamePrefix

必要參數

--gallery-name -r

資源庫名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--eula

社群資源庫發行者 eula。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--permissions

這個屬性可讓您指定共用資源庫的許可權。

接受的值: Community, Groups, Private

--public-name-prefix

社群資源庫公用名稱前置詞。

--publisher-email

社群資源庫發行者連絡電子郵件。

--publisher-uri

社群資源庫發行者 URI。

--remove

從清單中移除屬性或專案。範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []

--select

要套用至作業的選取表達式。「許可權」預設值為 None。

--set

指定要設定的屬性路徑和值，以更新物件。範例：--set property1.property2=<value>。

預設值: []

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az sig

命令

az sig create

範例

必要參數

選擇性參數

az sig create (image-gallery 擴充功能)

範例

必要參數

選擇性參數

az sig delete

選擇性參數

az sig list

選擇性參數

az sig list-community

範例

選擇性參數

az sig list-shared

範例

必要參數

選擇性參數

az sig show

選擇性參數

az sig show-community

選擇性參數

az sig show-community (image-gallery 擴充功能)

範例

選擇性參數

az sig show-shared

範例

選擇性參數

az sig update

範例

必要參數

選擇性參數

其他資源