az dt identity

Note

此參考是 Azure CLI azure-iot擴充套件（版本 2.70.0 或更高版本）的一部分。 擴充功能會在您第一次執行 az dt identity 命令時自動安裝。 深入了解擴充功能。

管理 Digital Twins 實例的身分識別。

命令

名稱	Description	類型	狀態
az dt identity assign	將受控識別指派給 Digital Twins 實例。	Extension	GA
az dt identity remove	從 Digital Twins 實例中移除受控識別。	Extension	GA
az dt identity show	顯示 Digital Twins 實例的身分識別屬性。	Extension	GA

az dt identity assign

將受控識別指派給 Digital Twins 實例。

az dt identity assign --dt-name --dtn
                      [--acquire-policy-token]
                      [--change-reference]
                      [--mi-system-assigned --system {false, true}]
                      [--mi-user-assigned --user]
                      [--resource-group]
                      [--role]
                      [--scopes]

範例

將系統指派的身分識別指派給 Digital Twins 實例，並將角色指派給該身分識別。

az dt identity assign -n {instance_name} --mi-system-assigned --role "Azure Event Hubs Data Sender" --scopes {resource_id}

將兩個使用者指派的身分識別指派給 Digital Twins instace。

az dt identity assign -n {instance_name} --mi-user-assigned {resource_id} {resource_id}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱。

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--mi-system-assigned --system

將系統指派的受控識別指派給這個 Digital Twin 實例。

屬性	值
接受的值:	false, true

--mi-user-assigned --user

將使用者指派的受控識別指派給這個 Digital Twin 實例。 接受以空格分隔的身分識別資源標識符清單。

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group={name}來設定預設群組。

--role

要指派給數字對應項系統指派受控識別的角色。

--scopes

空間分隔的範圍清單，以指派系統指派受控識別的角色（--role）。

全域參數

--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 dt identity remove

從 Digital Twins 實例中移除受控識別。

az dt identity remove --dt-name --dtn
                      [--acquire-policy-token]
                      [--change-reference]
                      [--mi-system-assigned --system {false, true}]
                      [--mi-user-assigned --user]
                      [--resource-group]

範例

從 Digital Twins 實例中移除系統指派的身分識別。

az dt identity remove -n {instance_name} --mi-system-assigned

從 Digital Twins 實例中移除兩個使用者指派的身分識別。

az dt identity remove -n {instance_name} --mi-user-assigned {resource_id} {resource_id}

從 Digital Twins 實例中移除所有身分識別。

az dt identity remove -n {instance_name} --mi-user-assigned --mi-system-assigned

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱。

選擇性參數

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

--acquire-policy-token

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

屬性	值
參數群組:	Global Policy Arguments

--change-reference

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

屬性	值
參數群組:	Global Policy Arguments

--mi-system-assigned --system

將系統指派的受控識別移除至此 Digital Twin 實例。

屬性	值
接受的值:	false, true

--mi-user-assigned --user

將使用者指派的受控識別移除至此 Digital Twin 實例。 接受以空格分隔的身分識別資源標識符清單。

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 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 dt identity show

顯示 Digital Twins 實例的身分識別屬性。

az dt identity show --dt-name --dtn
                    [--resource-group]

範例

顯示 Digital Twins 實例的身分識別屬性。

az dt identity show -n {instance_name} -g {resource_group}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱。

選擇性參數

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

--resource-group -g

Digital Twins 實例資源群組。 您可以使用 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