az iot hub module-identity
Note
このリファレンスは、Azure CLI (バージョン 2.59.0 以降) の azure-iot 拡張機能の一部です。 拡張機能は、az iot hub module-identity コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。
IoT デバイス モジュールを管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az iot hub module-identity connection-string |
IoT デバイス モジュールの接続文字列を管理します。 |
Extension | GA |
az iot hub module-identity connection-string show |
ターゲット IoT デバイス モジュールの接続文字列を表示します。 |
Extension | GA |
az iot hub module-identity create |
IoT Hub 内のターゲット IoT デバイスにモジュールを作成します。 |
Extension | GA |
az iot hub module-identity delete |
IoT Hub 内のデバイスを削除します。 |
Extension | GA |
az iot hub module-identity list |
IoT Hub 内の IoT デバイスにあるモジュールを一覧表示します。 |
Extension | GA |
az iot hub module-identity renew-key |
Sas 認証を使用して IoT Hub デバイス モジュールのターゲット キーを更新します。 |
Extension | GA |
az iot hub module-identity show |
IoT Hub 内の IoT デバイス モジュールの詳細を取得します。 |
Extension | GA |
az iot hub module-identity update |
IoT Hub デバイス モジュールを更新します。 |
Extension | GA |
az iot hub module-identity create
IoT Hub 内のターゲット IoT デバイスにモジュールを作成します。
shared_private_keyの認証方法 (対称キーとも呼ばれます) を使用する場合、カスタム キーが提供されていない場合、サービスによってモジュール用に生成されます。
az iot hub module-identity create --device-id
--module-id
[--am --auth-method {shared_private_key, x509_ca, x509_thumbprint}]
[--auth-type {key, login}]
[--hub-name]
[--login]
[--od --output-dir]
[--pk --primary-key]
[--primary-thumbprint --ptp]
[--resource-group]
[--secondary-key --sk]
[--secondary-thumbprint --stp]
[--valid-days --vd]
必須のパラメーター
ターゲット デバイス ID。
ターゲット モジュール ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
エンティティの作成に使用する承認方法。
プロパティ | 値 |
---|---|
規定値: | shared_private_key |
指定可能な値: | shared_private_key, x509_ca, x509_thumbprint |
操作でポリシー キーを自動的に派生させるか、現在の Azure AD セッションを使用するかを示します。 認証の種類がログインで、リソースホスト名が指定されている場合、リソース参照は必要でない限りスキップされます。既定値は、 az configure --defaults iothub-data-auth-type={auth-type-value}
を使用して構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Access Control Arguments |
規定値: | key |
指定可能な値: | key, login |
IoT Hub の名前またはホスト名。 --login が指定されていない場合は必須。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
このコマンドは、アクションを実行する権限を持つエンティティ 接続文字列をサポートします。 "az login" によるセッション ログインを回避するために使用します。 エンティティ接続文字列と名前の両方が指定されている場合、接続文字列が優先されます。 --hub-name が指定されていない場合は必須です。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
自己署名証明書を生成し、その拇印を使用します。 指定したターゲット ディレクトリへの出力。
プロパティ | 値 |
---|---|
Parameter group: | X.509 Arguments |
base64 形式で格納されている主対称共有アクセス キー。
プロパティ | 値 |
---|---|
Parameter group: | Symmetric Key Arguments |
プライマリ拇印に使用する自己署名証明書の拇印。
プロパティ | 値 |
---|---|
Parameter group: | X.509 Arguments |
リソース グループの名前。
az configure --defaults group=<name>
を使用して既定のグループを構成できます。
base64 形式で格納されているセカンダリ対称共有アクセス キー。
プロパティ | 値 |
---|---|
Parameter group: | Symmetric Key Arguments |
セカンダリ拇印に使用する自己署名証明書の拇印。
プロパティ | 値 |
---|---|
Parameter group: | X.509 Arguments |
自己署名証明書を生成し、その拇印を使用します。 指定した日数有効です。 既定値: 365。
プロパティ | 値 |
---|---|
Parameter group: | X.509 Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
出力フォーマット。
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az iot hub module-identity delete
IoT Hub 内のデバイスを削除します。
az iot hub module-identity delete --device-id
--module-id
[--auth-type {key, login}]
[--etag]
[--hub-name]
[--login]
[--resource-group]
必須のパラメーター
ターゲット デバイス ID。
ターゲット モジュール ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
操作でポリシー キーを自動的に派生させるか、現在の Azure AD セッションを使用するかを示します。 認証の種類がログインで、リソースホスト名が指定されている場合、リソース参照は必要でない限りスキップされます。既定値は、 az configure --defaults iothub-data-auth-type={auth-type-value}
を使用して構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Access Control Arguments |
規定値: | key |
指定可能な値: | key, login |
リソースの最後の状態に対応する Etag またはエンティティ タグ。 etag が指定されていない場合は、値 '*' が使用されます。
IoT Hub の名前またはホスト名。 --login が指定されていない場合は必須。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
このコマンドは、アクションを実行する権限を持つエンティティ 接続文字列をサポートします。 "az login" によるセッション ログインを回避するために使用します。 エンティティ接続文字列と名前の両方が指定されている場合、接続文字列が優先されます。 --hub-name が指定されていない場合は必須です。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
リソース グループの名前。
az configure --defaults group=<name>
を使用して既定のグループを構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
出力フォーマット。
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az iot hub module-identity list
IoT Hub 内の IoT デバイスにあるモジュールを一覧表示します。
az iot hub module-identity list --device-id
[--auth-type {key, login}]
[--hub-name]
[--login]
[--resource-group]
[--top]
必須のパラメーター
ターゲット デバイス ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
操作でポリシー キーを自動的に派生させるか、現在の Azure AD セッションを使用するかを示します。 認証の種類がログインで、リソースホスト名が指定されている場合、リソース参照は必要でない限りスキップされます。既定値は、 az configure --defaults iothub-data-auth-type={auth-type-value}
を使用して構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Access Control Arguments |
規定値: | key |
指定可能な値: | key, login |
IoT Hub の名前またはホスト名。 --login が指定されていない場合は必須。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
このコマンドは、アクションを実行する権限を持つエンティティ 接続文字列をサポートします。 "az login" によるセッション ログインを回避するために使用します。 エンティティ接続文字列と名前の両方が指定されている場合、接続文字列が優先されます。 --hub-name が指定されていない場合は必須です。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
リソース グループの名前。
az configure --defaults group=<name>
を使用して既定のグループを構成できます。
返される要素の最大数。 無制限に -1 を使用します。
プロパティ | 値 |
---|---|
規定値: | 1000 |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
出力フォーマット。
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az iot hub module-identity renew-key
Sas 認証を使用して IoT Hub デバイス モジュールのターゲット キーを更新します。
現在、一括キーの再生成では、etag とキーの種類 swap
はサポートされていません。
一括キーの再生成では、1 つのモジュール キーの再生成とは異なる出力形式が使用されます。
az iot hub module-identity renew-key --device-id
--hub-name
--key-type --kt {both, primary, secondary, swap}
--module-id
[--auth-type {key, login}]
[--etag]
[--login]
[--no-progress {false, true}]
[--resource-group]
例
主キーを更新します。
az iot hub module-identity renew-key -m {module_name} -d {device_id} -n {iothub_name} --kt primary
プライマリ キーとセカンダリ キーを交換します。
az iot hub module-identity renew-key -m {module_name} -d {device_id} -n {iothub_name} --kt swap
2 つのモジュールのセカンダリ キーを更新します。
az iot hub module-identity renew-key -m {module_name} {module_name} -d {device_id} -n {iothub_name} --kt secondary
デバイス内のすべてのモジュールの両方のキーを更新します。
az iot hub module-identity renew-key -m * -d {device_id} -n {iothub_name} --kt both
必須のパラメーター
ターゲット デバイス ID。
IoT Hub の名前またはホスト名。 --login が指定されていない場合は必須。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
再生成するターゲット キーの種類。
プロパティ | 値 |
---|---|
指定可能な値: | both, primary, secondary, swap |
ターゲット モジュール ID のスペース区切りの一覧。 すべてのモジュールに *
を使用します。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
操作でポリシー キーを自動的に派生させるか、現在の Azure AD セッションを使用するかを示します。 認証の種類がログインで、リソースホスト名が指定されている場合、リソース参照は必要でない限りスキップされます。既定値は、 az configure --defaults iothub-data-auth-type={auth-type-value}
を使用して構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Access Control Arguments |
規定値: | key |
指定可能な値: | key, login |
リソースの最後の状態に対応する Etag またはエンティティ タグ。 etag が指定されていない場合は、値 '*' が使用されます。 この引数は、swap
にのみ適用されます。
このコマンドは、アクションを実行する権限を持つエンティティ 接続文字列をサポートします。 "az login" によるセッション ログインを回避するために使用します。 エンティティ接続文字列と名前の両方が指定されている場合、接続文字列が優先されます。 --hub-name が指定されていない場合は必須です。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
一括キー再生成の進行状況バーを非表示にします。
プロパティ | 値 |
---|---|
指定可能な値: | false, true |
リソース グループの名前。
az configure --defaults group=<name>
を使用して既定のグループを構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
出力フォーマット。
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az iot hub module-identity show
IoT Hub 内の IoT デバイス モジュールの詳細を取得します。
az iot hub module-identity show --device-id
--module-id
[--auth-type {key, login}]
[--hub-name]
[--login]
[--resource-group]
必須のパラメーター
ターゲット デバイス ID。
ターゲット モジュール ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
操作でポリシー キーを自動的に派生させるか、現在の Azure AD セッションを使用するかを示します。 認証の種類がログインで、リソースホスト名が指定されている場合、リソース参照は必要でない限りスキップされます。既定値は、 az configure --defaults iothub-data-auth-type={auth-type-value}
を使用して構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Access Control Arguments |
規定値: | key |
指定可能な値: | key, login |
IoT Hub の名前またはホスト名。 --login が指定されていない場合は必須。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
このコマンドは、アクションを実行する権限を持つエンティティ 接続文字列をサポートします。 "az login" によるセッション ログインを回避するために使用します。 エンティティ接続文字列と名前の両方が指定されている場合、接続文字列が優先されます。 --hub-name が指定されていない場合は必須です。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
リソース グループの名前。
az configure --defaults group=<name>
を使用して既定のグループを構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
出力フォーマット。
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |
az iot hub module-identity update
IoT Hub デバイス モジュールを更新します。
モジュールを更新するために、--set の後にプロパティの割り当てを使用します。 "iot hub module-identity show" から返されるプロパティを活用します。
az iot hub module-identity update --device-id
--module-id
[--add]
[--auth-type {key, login}]
[--etag]
[--force-string]
[--hub-name]
[--login]
[--remove]
[--resource-group]
[--set]
例
モジュールの対称認証キーを再生成する
az iot hub module-identity update -m {module_name} -d {device_id} -n {iothub_name} --set authentication.symmetricKey.primaryKey="" authentication.symmetricKey.secondaryKey=""
必須のパラメーター
ターゲット デバイス ID。
ターゲット モジュール ID。
省略可能のパラメーター
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>
。
プロパティ | 値 |
---|---|
Parameter group: | Generic Update Arguments |
規定値: | [] |
操作でポリシー キーを自動的に派生させるか、現在の Azure AD セッションを使用するかを示します。 認証の種類がログインで、リソースホスト名が指定されている場合、リソース参照は必要でない限りスキップされます。既定値は、 az configure --defaults iothub-data-auth-type={auth-type-value}
を使用して構成できます。
プロパティ | 値 |
---|---|
Parameter group: | Access Control Arguments |
規定値: | key |
指定可能な値: | key, login |
リソースの最後の状態に対応する Etag またはエンティティ タグ。 etag が指定されていない場合は、値 '*' が使用されます。
'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。
プロパティ | 値 |
---|---|
Parameter group: | Generic Update Arguments |
規定値: | False |
IoT Hub の名前またはホスト名。 --login が指定されていない場合は必須。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
このコマンドは、アクションを実行する権限を持つエンティティ 接続文字列をサポートします。 "az login" によるセッション ログインを回避するために使用します。 エンティティ接続文字列と名前の両方が指定されている場合、接続文字列が優先されます。 --hub-name が指定されていない場合は必須です。
プロパティ | 値 |
---|---|
Parameter group: | IoT Hub Identifier Arguments |
リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove>
OR --remove propertyToRemove
。
プロパティ | 値 |
---|---|
Parameter group: | Generic Update Arguments |
規定値: | [] |
リソース グループの名前。
az configure --defaults group=<name>
を使用して既定のグループを構成できます。
設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>
。
プロパティ | 値 |
---|---|
Parameter group: | Generic Update Arguments |
規定値: | [] |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
プロパティ | 値 |
---|---|
規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
プロパティ | 値 |
---|---|
規定値: | False |
出力フォーマット。
プロパティ | 値 |
---|---|
規定値: | json |
指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID
を使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
プロパティ | 値 |
---|---|
規定値: | False |