WindowsOfficeClientConfiguration を作成するCreate windowsOfficeClientConfiguration

名前空間: microsoft.graphNamespace: microsoft.graph

重要: ベータ版の Microsoft Graph Api は変更される可能性があります。運用環境での使用はサポートされていません。Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

注: Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

ターゲットグループを使用して、新しいセキュリティで保護されていないポリシーを作成します。Create a new non-security policy with targeting groups.

前提条件Prerequisites

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の大きいものから小さいものへ)Permissions (from most to least privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All

HTTP 要求HTTP Request

POST /officeConfiguration/clientConfigurations

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー <トークン> が必要です。Bearer <token> Required.
承諾Accept application/jsonapplication/json

要求本文Request body

要求本文で、 windowsOfficeClientConfiguration オブジェクトの JSON 表記を指定します。In the request body, supply a JSON representation for the windowsOfficeClientConfiguration object.

次の表に、 windowsOfficeClientConfigurationの作成時に必要なプロパティを示します。The following table shows the properties that are required when you create the windowsOfficeClientConfiguration.

プロパティProperty Type 説明Description
idid StringString Office クライアント構成ポリシーの Id。Id of the office client configuration policy. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
userPreferencePayloaduserPreferencePayload StreamStream プリファレンス設定 JSON 文字列はバイナリ形式です。これらの値はユーザーが上書きできます。Preference settings JSON string in binary format, these values can be overridden by the user. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
policyPayloadpolicyPayload StreamStream ポリシー設定 JSON 文字列 (バイナリ形式) では、ユーザーがこれらの値を変更することはできません。Policy settings JSON string in binary format, these values cannot be changed by the user. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
descriptiondescription StringString 管理者が提供する office クライアント構成ポリシーの説明。Admin provided description of the office client configuration policy. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
displayNamedisplayName StringString 管理者が指定した office クライアント構成ポリシーの名前。Admin provided name of the office client configuration policy. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
assignmentsassignments officeClientConfigurationAssignment コレクションofficeClientConfigurationAssignment collection ポリシーのグループの割り当てのリスト。The list of group assignments for the policy.. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
prioritypriority Int32Int32 優先度の値は、テナントの各ポリシーの一意の値である必要があり、競合の解決に使用されます。低い値は、優先度が高くなります。Priority value should be unique value for each policy under a tenant and will be used for conflict resolution, lower values mean priority is high. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
lastModifiedDateTimelastModifiedDateTime DateTimeDateTime ポリシーの最終更新日時スタンプ。Last modified datetime stamp of the policy. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
userCheckinSummaryuserCheckinSummary officeUserCheckinSummaryofficeUserCheckinSummary ポリシーのユーザーチェックインの概要。User check-in summary for the policy. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration
checkinStatusescheckinStatuses officeClientCheckinStatus コレクションofficeClientCheckinStatus collection Office クライアントのチェックイン状態のリスト。List of office Client check-in status. OfficeClientConfigurationから継承します。Inherited from officeClientConfiguration

応答Response

成功した場合、このメソッドは応答 201 Created コードと、応答本文で windowsOfficeClientConfiguration オブジェクトを返します。If successful, this method returns a 201 Created response code and a windowsOfficeClientConfiguration object in the response body.

Example

要求Request

以下は、要求の例です。Here is an example of the request.

POST https://graph.microsoft.com/beta/officeConfiguration/clientConfigurations
Content-type: application/json
Content-length: 1020

{
  "@odata.type": "#microsoft.graph.windowsOfficeClientConfiguration",
  "userPreferencePayload": "<Unknown Primitive Type Edm.Stream>",
  "policyPayload": "<Unknown Primitive Type Edm.Stream>",
  "description": "Description value",
  "displayName": "Display Name value",
  "priority": 8,
  "userCheckinSummary": {
    "@odata.type": "microsoft.graph.officeUserCheckinSummary",
    "succeededUserCount": 2,
    "failedUserCount": 15
  },
  "checkinStatuses": [
    {
      "@odata.type": "microsoft.graph.officeClientCheckinStatus",
      "userPrincipalName": "User Principal Name value",
      "deviceName": "Device Name value",
      "devicePlatform": "Device Platform value",
      "devicePlatformVersion": "Device Platform Version value",
      "wasSuccessful": true,
      "userId": "User Id value",
      "checkinDateTime": "2016-12-31T23:56:33.9571764-08:00",
      "errorMessage": "Error Message value",
      "appliedPolicies": [
        "Applied Policies value"
      ]
    }
  ]
}

応答Response

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

{
  "@odata.type": "#microsoft.graph.windowsOfficeClientConfiguration",
  "id": "13a5ac73-ac73-13a5-73ac-a51373aca513",
  "userPreferencePayload": "<Unknown Primitive Type Edm.Stream>",
  "policyPayload": "<Unknown Primitive Type Edm.Stream>",
  "description": "Description value",
  "displayName": "Display Name value",
  "priority": 8,
  "userCheckinSummary": {
    "@odata.type": "microsoft.graph.officeUserCheckinSummary",
    "succeededUserCount": 2,
    "failedUserCount": 15
  },
  "checkinStatuses": [
    {
      "@odata.type": "microsoft.graph.officeClientCheckinStatus",
      "userPrincipalName": "User Principal Name value",
      "deviceName": "Device Name value",
      "devicePlatform": "Device Platform value",
      "devicePlatformVersion": "Device Platform Version value",
      "wasSuccessful": true,
      "userId": "User Id value",
      "checkinDateTime": "2016-12-31T23:56:33.9571764-08:00",
      "errorMessage": "Error Message value",
      "appliedPolicies": [
        "Applied Policies value"
      ]
    }
  ]
}