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]
              [--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

社群資源庫發行者 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 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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --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]
              [--soft-delete {false, true}]

範例

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

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>

預設值: []
--soft-delete
預覽

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

接受的值: false, true
全域參數
--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 來取得完整偵錯記錄。