az sig

Note

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

管理共用映像庫。

命令

名稱	Description	類型	狀態
az sig create	建立共用映像庫。	Core	GA
az sig create (image-gallery 擴充功能)	建立 共用映像庫。	Extension	GA
az sig delete	刪除 共用映像庫。	Core	GA
az sig gallery-application	管理資源庫應用程式。	Core	GA
az sig gallery-application create	建立資源庫應用程式定義。	Core	GA
az sig gallery-application delete	刪除資源庫應用程式。	Core	GA
az sig gallery-application list	列出資源庫中的資源庫應用程式定義。	Core	GA
az sig gallery-application show	取得資源庫應用程式定義的相關信息。	Core	GA
az sig gallery-application update	更新資源庫應用程式定義。	Core	GA
az sig gallery-application version	管理資源庫應用程式版本。	Core	GA
az sig gallery-application version create	建立資源庫應用程式版本。	Core	GA
az sig gallery-application version delete	刪除資源庫應用程式版本。	Core	GA
az sig gallery-application version list	列出資源庫應用程式版本。	Core	GA
az sig gallery-application version show	取得資源庫應用程式版本的相關信息。	Core	GA
az sig gallery-application version update	更新資源庫應用程式版本。	Core	GA
az sig gallery-application version wait	將 CLI 置於等候狀態，直到符合條件為止。	Core	GA
az sig gallery-application wait	將 CLI 置於等候狀態，直到符合條件為止。	Core	GA
az sig identity	管理身分識別。	Core	GA
az sig identity assign	指派用戶或系統受控識別。	Core	GA
az sig identity remove	拿掉使用者或系統受控識別。	Core	GA
az sig identity show	顯示受控識別的詳細數據。	Core	GA
az sig image-definition	使用 VM 管理共用資源庫映像。	核心和擴充功能	GA
az sig image-definition create	建立資源庫映像定義。	Core	GA
az sig image-definition delete	刪除資源庫映像。	Core	GA
az sig image-definition list	列出資源庫中的圖庫映像定義。	Core	GA
az sig image-definition list-community	列出資源庫社群中的 VM 映像定義。	Core	GA
az sig image-definition list-community (image-gallery 擴充功能)	列出資源庫社群中的 VM 映像定義（預覽版）。	Extension	Experimental
az sig image-definition list-shared	列出直接與您的訂用帳戶或租用戶共享的資源庫中的 VM 映像定義。	Core	GA
az sig image-definition show	取得資源庫映像定義的相關信息。	Core	GA
az sig image-definition show-community	取得社群資源庫映像。	Core	GA
az sig image-definition show-community (image-gallery 擴充功能)	在資源庫社群中取得影像（預覽版）。	Extension	Experimental
az sig image-definition show-shared	取得共享資源庫映像。	Core	GA
az sig image-definition update	更新 VM 映像定義。	Core	GA
az sig image-definition wait	將 CLI 置於等候狀態，直到符合條件為止。	Core	GA
az sig image-version	使用 VM 管理共用資源庫映像版本。	核心和擴充功能	GA
az sig image-version create	建立新的映像版本。	Core	GA
az sig image-version delete	刪除資源庫映像版本。	Core	GA
az sig image-version list	列出資源庫映像定義中的資源庫映像版本。	Core	GA
az sig image-version list-community	列出資源庫社群中的 VM 映像版本。	Core	GA
az sig image-version list-community (image-gallery 擴充功能)	列出資源庫社群中的 VM 映像版本（預覽版）。	Extension	Experimental
az sig image-version list-shared	列出直接與您的訂用帳戶或租用戶共用的資源庫中的 VM 映射版本。	Core	GA
az sig image-version show	取得資源庫映像版本的相關信息。	Core	GA
az sig image-version show-community	取得社群資源庫映像版本。	Core	GA
az sig image-version show-community (image-gallery 擴充功能)	在資源庫社群中取得映像版本（預覽版）。	Extension	Experimental
az sig image-version show-shared	在直接與您的訂用帳戶或租用戶共享的資源庫中取得映像版本。	Core	GA
az sig image-version undelete	還原虛刪除的映像版本。	Core	Preview
az sig image-version update	更新共用映像版本。	Core	GA
az sig image-version wait	將 CLI 置於等候狀態，直到符合條件為止。	Core	GA
az sig in-vm-access-control-profile	在 VM 存取控制設定檔中管理。	Core	GA
az sig in-vm-access-control-profile-version	在 VM 存取控制設定檔版本中管理。	Core	GA
az sig in-vm-access-control-profile-version create	在 VM 存取控制設定檔版本中建立資源庫。	Core	GA
az sig in-vm-access-control-profile-version delete	刪除 VM 存取控制設定檔版本中的資源庫。	Core	GA
az sig in-vm-access-control-profile-version list	在 VM 存取控制設定檔中資源庫中列出 VM 存取控制設定檔中的資源庫版本。	Core	GA
az sig in-vm-access-control-profile-version show	取得 VM 存取控制設定檔版本中資源庫的相關信息。	Core	GA
az sig in-vm-access-control-profile-version update	更新 VM 存取控制設定檔版本中的資源庫。	Core	GA
az sig in-vm-access-control-profile-version wait	將 CLI 置於等候狀態，直到符合條件為止。	Core	GA
az sig in-vm-access-control-profile create	在 VM 存取控制設定檔中建立資源庫。	Core	GA
az sig in-vm-access-control-profile delete	刪除 VM 存取控制設定檔中的資源庫。	Core	GA
az sig in-vm-access-control-profile list	資源庫中 VM 存取控制設定檔中的清單庫。	Core	GA
az sig in-vm-access-control-profile show	取得 VM 存取控制設定檔中資源庫的相關信息。	Core	GA
az sig in-vm-access-control-profile update	更新 VM 存取控制設定檔中的資源庫。	Core	GA
az sig in-vm-access-control-profile wait	將 CLI 置於等候狀態，直到符合條件為止。	Core	GA
az sig list	列出資源群組底下的資源庫。	Core	GA
az sig list-community	列出直接與您的訂用帳戶或租用戶共用的所有社群資源庫。	Core	GA
az sig list-shared	列出所有直接與您訂用帳戶或租用戶共用的共享資源庫。	Core	GA
az sig share	管理資源庫共用配置檔。	核心和擴充功能	GA
az sig share add	與訂用帳戶和租用戶共享資源庫。	Core	GA
az sig share enable-community	允許將資源庫共用給社群。	Core	GA
az sig share enable-community (image-gallery 擴充功能)	允許將資源庫共用給社群。	Extension	GA
az sig share remove	停止與訂用帳戶或租用戶共享資源庫。	Core	GA
az sig share reset	停用資源庫與訂用帳戶或租用戶共用。	Core	GA
az sig share wait	將 CLI 置於等候狀態，直到符合共用資源庫的條件為止。	Core	GA
az sig show	檢索有關 共用映像庫 的資訊。	Core	GA
az sig show-community	依資源庫公用名稱取得社群資源庫。	Core	GA
az sig show-community (image-gallery 擴充功能)	取得已是社群的圖庫（預覽版）。	Extension	Experimental
az sig show-shared	取得已直接共用至訂用帳戶或租用戶的資源庫。	Core	GA
az sig update	更新共用影像庫。	Core	GA
az sig wait	將 CLI 置於等候狀態，直到符合條件為止。	Core	GA

az sig create

建立共用映像庫。

az sig create --gallery-name
              --resource-group
              [--acquire-policy-token]
              [--change-reference]
              [--description]
              [--eula]
              [--location]
              [--mi-system-assigned --system-assigned]
              [--mi-user-assigned --user-assigned]
              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
              [--permissions {Community, Groups, Private}]
              [--public-name-prefix]
              [--publisher-contact --publisher-email]
              [--publisher-uri]
              [--soft-delete {0, 1, f, false, n, no, t, true, y, yes}]
              [--tags]

範例

建立共用映像庫

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

建立一個啟用系統指定身份的共享圖片庫。

az sig create --resource-group MyResourceGroup --gallery-name MyGallery123 --system-assigned

建立一個共用圖片庫，並設定使用者指定的身份。

az sig create --resource-group MyResourceGroup --gallery-name MyGallery123 --user-assigned id1

建立一個共享圖片庫，包含系統與使用者指派的身份。

az sig create --resource-group MyResourceGroup --gallery-name MyGallery123 --system-assigned --user-assigned id1

必要參數

--gallery-name -r

共用映像庫 的名稱。

--resource-group -g

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--description

資源庫的描述。

屬性	值
參數群組:	Properties Arguments

--eula

社群資源庫發行者 eula。

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--location -l

資源位置 未指定時，將會使用資源群組的位置。

屬性	值
參數群組:	Gallery Arguments

--mi-system-assigned --system-assigned

設定系統受控識別。

屬性	值
參數群組:	Identity Arguments

--mi-user-assigned --user-assigned

設定使用者受控識別。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Identity Arguments

--no-wait

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

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

--permissions

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

屬性	值
參數群組:	SharingProfile Arguments
接受的值:	Community, Groups, Private

--public-name-prefix

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

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--publisher-contact --publisher-email

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

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--publisher-uri

社群資源庫發行者 URI。

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--soft-delete

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

屬性	值
參數群組:	SoftDeletePolicy Arguments
接受的值:	0, 1, f, false, n, no, t, true, y, yes

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Gallery Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

建立 共用映像庫。

az sig create --gallery-name
              --resource-group
              [--acquire-policy-token]
              [--change-reference]
              [--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>來設定預設群組。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--description

資源庫的描述。

--eula

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

--location -l

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

--permissions

實驗

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

屬性	值
參數群組:	Sharing Profile Arguments
接受的值:	Community, Groups, Private

--public-name-prefix

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

--publisher-email

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

--publisher-uri

社群資源庫發行者 URI。

--soft-delete

預覽

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

屬性	值
接受的值:	false, true

--tags

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig delete

刪除 共用映像庫。

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--gallery-name -r

共用映像庫 的名稱將被刪除。

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

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

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig list

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

az sig list [--max-items]
            [--next-token]
            [--resource-group]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--max-items

命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。 若要繼續分頁，請在後續命令的 --next-token 自變數中提供令牌值。

屬性	值
參數群組:	Pagination Arguments

--next-token

標記，指定要開始分頁的位置。 這是先前截斷回應中的令牌值。

屬性	值
參數群組:	Pagination Arguments

--resource-group -g

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig list-community

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

az sig list-community [--acquire-policy-token]
                      [--change-reference]
                      [--location]
                      [--marker]
                      [--show-next-marker]

範例

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

az sig list-community --location myLocation

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

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--location -l

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

--marker

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

--show-next-marker

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig list-shared

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

az sig list-shared --location
                   [--acquire-policy-token]
                   [--change-reference]
                   [--max-items]
                   [--next-token]
                   [--shared-to {tenant}]

範例

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

az sig list-shared --location myLocation

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

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

必要參數

--location -l

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--max-items

命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。 若要繼續分頁，請在後續命令的 --next-token 自變數中提供令牌值。

屬性	值
參數群組:	Pagination Arguments

--next-token

標記，指定要開始分頁的位置。 這是先前截斷回應中的令牌值。

屬性	值
參數群組:	Pagination Arguments

--shared-to

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

屬性	值
接受的值:	tenant

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig show

檢索有關 共用映像庫 的資訊。

az sig show [--gallery-name]
            [--ids]
            [--resource-group]
            [--select {Permissions}]
            [--sharing-groups {0, 1, f, false, n, no, t, true, y, yes}]
            [--subscription]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--gallery-name -r

共用映像庫 的名稱。

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--select

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

屬性	值
接受的值:	Permissions

--sharing-groups

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

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

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig show-community

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

az sig show-community [--acquire-policy-token]
                      [--change-reference]
                      [--ids]
                      [--location]
                      [--name --public-gallery-name]
                      [--subscription]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--location -l

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

屬性	值
參數群組:	Resource Id Arguments

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

社群資源庫的公用名稱。

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

實驗

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

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

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

az sig show-community [--acquire-policy-token]
                      [--change-reference]
                      [--ids]
                      [--location]
                      [--public-gallery-name]
                      [--subscription]

範例

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

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--location -l

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

屬性	值
參數群組:	Resource Id Arguments

--public-gallery-name

社群資源庫的公用名稱。

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig show-shared

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

az sig show-shared [--acquire-policy-token]
                   [--change-reference]
                   [--gallery-unique-name --name]
                   [--ids]
                   [--location]
                   [--subscription]

範例

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

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

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

共用資源庫的唯一名稱。

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--location -l

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig update

更新共用影像庫。

az sig update [--acquire-policy-token]
              [--add]
              [--change-reference]
              [--eula]
              [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
              [--gallery-name]
              [--ids]
              [--location]
              [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
              [--permissions {Community, Groups, Private}]
              [--public-name-prefix]
              [--publisher-contact --publisher-email]
              [--publisher-uri]
              [--remove]
              [--resource-group]
              [--set]
              [--soft-delete {0, 1, f, false, n, no, t, true, y, yes}]
              [--subscription]

範例

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

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--add

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

屬性	值
參數群組:	Generic Update Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--eula

社群資源庫發行者 eula。

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--force-string

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

屬性	值
參數群組:	Generic Update Arguments
接受的值:	0, 1, f, false, n, no, t, true, y, yes

--gallery-name -r

共用映像庫 的名稱將被刪除。

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--location -l

資源位置。

屬性	值
參數群組:	Gallery Arguments

--no-wait

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

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

--permissions

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

屬性	值
參數群組:	SharingProfile Arguments
接受的值:	Community, Groups, Private

--public-name-prefix

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

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--publisher-contact --publisher-email

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

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--publisher-uri

社群資源庫發行者 URI。

屬性	值
參數群組:	CommunityGalleryInfo Arguments

--remove

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

屬性	值
參數群組:	Generic Update Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--set

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

屬性	值
參數群組:	Generic Update Arguments

--soft-delete

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

屬性	值
參數群組:	SoftDeletePolicy Arguments
接受的值:	0, 1, f, false, n, no, t, true, y, yes

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az sig wait

將 CLI 置於等候狀態，直到符合條件為止。

az sig wait [--acquire-policy-token]
            [--change-reference]
            [--created]
            [--custom]
            [--deleted]
            [--exists]
            [--expand {SharingProfile/Groups}]
            [--gallery-name]
            [--ids]
            [--interval]
            [--resource-group]
            [--select {Permissions}]
            [--subscription]
            [--timeout]
            [--updated]

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

屬性	值
參數群組:	Wait Condition Arguments

--deleted

等到刪除為止。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--exists

等候資源存在。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--expand

要套用至作業的展開查詢選項。

屬性	值
接受的值:	SharingProfile/Groups

--gallery-name -r

共用映像庫 的名稱。

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--interval

輪詢間隔以秒為單位。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	30

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--select

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

屬性	值
接受的值:	Permissions

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--timeout

以秒為單位的等候上限。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	3600

--updated

等到 provisioningState 更新為 'Succeeded'。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False