deviceTemplate リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
デバイス オブジェクトのセットに共通するプロパティ値を表します。 テンプレートのプロパティは、このテンプレートに基づいて作成されたすべての デバイス オブジェクトにスタンプされます。 このオブジェクトは不変です。
directoryObject から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | deviceTemplate コレクション | ディレクトリに登録されている deviceTemplate オブジェクトの一覧を取得します。 |
| Create | deviceTemplate | 属性を識別し、同様の特性を持つデバイスのグループを管理するために使用する新しい deviceTemplate を作成します。 |
| Get | deviceTemplate | deviceTemplate オブジェクトのプロパティとリレーションシップを取得します。 |
| Delete | なし | 登録済みの deviceTemplate を削除します。 |
| 所有者を一覧表示する | directoryObject コレクション | deviceTemplate オブジェクトの所有者の一覧を取得します。 |
| Add owner | なし | deviceTemplate オブジェクトに新しい所有者を追加します。 |
| 所有者を削除する | なし | deviceTemplate オブジェクトから所有者を削除します。 |
| テンプレートからデバイスを作成する | device | deviceTemplate から新しいデバイスを作成します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| deletedDateTime | DateTimeOffset | このオブジェクトが削除された日時。 オブジェクトが削除されていない場合は常に null。
directoryObject から継承されます。 |
| deviceAuthority | String | Microsoft Entra テナントでのデバイスのプロビジョニングと管理を担当するパーティのテナント定義名。 たとえば、Tailwind Traders (製造元) は、顧客の建物にインストールされ、Lakeshore Retail (デバイス機関) によって管理されるセキュリティ カメラを作成します。 この値は、デバイス機関 (製造元またはリセラー) によって顧客に提供されます。 |
| id | 文字列 | オブジェクトの一意の識別子。
directoryObject から継承されます。 読み取り専用です。
$filter (eq、in) をサポートします。 |
| manufacturer | String | 製造元名。 |
| model | String | モデル名。 |
| mutualTlsOauthConfigurationId | String | mutualTlsOauthConfiguration のオブジェクト ID。 自己署名証明書を使用する場合、この値は必要ありません。 この値は、デバイス機関 (製造元またはリセラー) によって顧客に提供されます。 |
| mutualTlsOauthConfigurationTenantId | String | mutualTlsOauthConfiguration を含むテナントの ID (デバイス機関のテナント ID)。 自己署名証明書を使用する場合、この値は必要ありません。 この値は、デバイス機関 (製造元またはリセラー) によって顧客に提供されます。 |
| operatingSystem | String | オペレーティング システムの種類。
$filter (eq、in) をサポートします。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| deviceInstances | device コレクション | このテンプレートに基づいて作成された デバイス オブジェクトのコレクション。 |
| owners | directoryObject コレクション | デバイス テンプレートと関連する deviceInstances を管理できるディレクトリ オブジェクトのコレクション。 所有者は、 サービス プリンシパル、 ユーザー、または アプリケーションとして表すことができます。 所有者にはデバイス テンプレートに対する完全な権限があり、このテンプレートのデバイスの作成、更新、削除、テンプレート所有者の追加または削除に他の管理者ロールは必要ありません。 デバイス テンプレートには最大 100 人の所有者が存在する可能性があります。 $expand をサポートします。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.deviceTemplate",
"deletedDateTime": "String (timestamp)",
"deviceAuthority": "String",
"id": "String (identifier)",
"manufacturer": "String",
"model": "String",
"mutualTlsOauthConfigurationId": "String",
"mutualTlsOauthConfigurationTenantId": "String",
"operatingSystem": "String"
}