deviceManagementConfigurationRedirectSettingDefinition を作成する

[アーティクル]
07/07/2022

名前空間: microsoft.graph

大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。

注: Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

新しい deviceManagementConfigurationRedirectSettingDefinition オブジェクトを作成します。

前提条件

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	DeviceManagementConfiguration.ReadWrite.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	DeviceManagementConfiguration.ReadWrite.All

HTTP 要求

POST /deviceManagement/reusableSettings
POST /deviceManagement/complianceSettings
POST /deviceManagement/configurationSettings
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions
POST /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions

要求ヘッダー

ヘッダー	値
Authorization	ベアラー <トークン> が必要です。
承諾	application/json

要求本文

要求本文で、deviceManagementConfigurationRedirectSettingDefinition オブジェクトの JSON 表現を指定します。

次の表は、deviceManagementConfigurationRedirectSettingDefinition を作成するときに必要なプロパティを示しています。

プロパティ	型	説明
適用	deviceManagementConfigurationSettingApplicability	deviceManagementConfigurationSettingDefinition から継承に適用されるデバイス設定の詳細
accessTypes	deviceManagementConfigurationSettingAccessTypes	deviceManagementConfigurationSettingDefinition から継承された設定の読み取り/書き込みアクセスモード。可能な値は、`none`、`add`、`copy`、`delete`、`get`、`replace`、`execute` です。
keywords	String collection	deviceManagementConfigurationSettingDefinition から継承された設定を検索するトークン
infoUrls	String コレクション	設定に関する詳細情報のリンクの一覧は、deviceManagementConfigurationSettingDefinition から継承されたページで確認できます。
発生	deviceManagementConfigurationSettingOccurrence	設定が deviceManagementConfigurationSettingDefinition から継承される必要があるかどうかを示します
Baseuri	String	deviceManagementConfigurationSettingDefinition から継承された基本 CSP パス
offsetUri	String	deviceManagementConfigurationSettingDefinition から継承されたベースからの CSP パスのオフセット
rootDefinitionId	String	設定が子設定の場合は、ルート設定定義。 deviceManagementConfigurationSettingDefinition から継承
Categoryid	String	deviceManagementConfigurationSettingDefinition から継承された、指定された構成サービスプロバイダー (CSP) で設定を構成する領域グループを指定します。
settingUsage	deviceManagementConfigurationSettingUsage	設定の種類 (たとえば、 deviceManagementConfigurationSettingDefinition から継承された構成とコンプライアンスなど)。可能な値は `none`、`configuration`、`compliance` です。
uxBehavior	deviceManagementConfigurationControlType	deviceManagementConfigurationSettingDefinition から継承された UX でコントロールの種類表現を設定します。可能な値は、`default`、`dropdown`、`smallTextBox`、`largeTextBox`、`toggle`、`multiheaderGrid`、`contextPane` です。
visibility	deviceManagementConfigurationSettingVisibility	可視性スコープを deviceManagementConfigurationSettingDefinition から継承された UX に設定します。可能な値は `none`、`settingsCatalog`、`template` です。
referredSettingInformationList	deviceManagementConfigurationReferredSettingInformation コレクション	参照される設定情報の一覧。 deviceManagementConfigurationSettingDefinition から継承
id	String	deviceManagementConfigurationSettingDefinition から継承されたアイテムの識別子
説明	String	deviceManagementConfigurationSettingDefinition から継承された項目の説明
Helptext	String	deviceManagementConfigurationSettingDefinition から継承されたアイテムのヘルプテキスト
name	String	deviceManagementConfigurationSettingDefinition から継承されたアイテムの名前
displayName	String	deviceManagementConfigurationSettingDefinition から継承された項目の表示名
version	String	deviceManagementConfigurationSettingDefinition から継承されたアイテムバージョン
deepLink	String	機能のサポートを管理する必要があるIntune コンソール内の特定の場所を指すディープリンク。
redirectMessage	String	リンクをクリックすると、ユーザーがサポートされているページにリダイレクトされて設定が管理されることを説明するメッセージ。
redirectReason	String	ユーザーをコンソールの別の場所にリダイレクトする理由を示します。たとえば、WiFi プロファイルは設定カタログではサポートされておらず、テンプレートポリシーを使用して作成する必要があります。

応答

成功した場合、このメソッドは 201 Created 応答コードと、応答本文の deviceManagementConfigurationRedirectSettingDefinition オブジェクトを返します。

例

要求

以下は、要求の例です。

POST https://graph.microsoft.com/beta/deviceManagement/reusableSettings
Content-type: application/json
Content-length: 1396

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason value"
}

応答

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1445

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationRedirectSettingDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "3e6c3eab-3eab-3e6c-ab3e-6c3eab3e6c3e",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "deepLink": "Deep Link value",
  "redirectMessage": "Redirect Message value",
  "redirectReason": "Redirect Reason value"
}

deviceManagementConfigurationRedirectSettingDefinition を作成する

前提条件

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック