androidForWorkGeneralDeviceConfiguration を作成する

名前空間: microsoft.graph

重要:Microsoft は Intune /beta API をサポートしていますが、より頻繁に変更される可能性があります。 可能な場合は、バージョン v1.0 を使用することをお勧めします。 バージョン セレクターを使用して、バージョン v1.0 で API が使用できるかどうかを確認します。

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

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

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

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

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

HTTP 要求

POST /deviceManagement/deviceConfigurations
POST /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
承諾 application/json

要求本文

リクエスト本文で、androidForWorkGeneralDeviceConfiguration オブジェクトの JSON 表現を指定します。

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

プロパティ 型 説明
id String エンティティのキー。 deviceConfiguration から継承します
lastModifiedDateTime DateTimeOffset オブジェクトの最終更新の DateTime。 deviceConfiguration から継承します
roleScopeTagIds String collection このエンティティ インスタンスのスコープ タグの一覧。 deviceConfiguration から継承します
supportsScopeTags ブール型 基になるデバイス構成がスコープ タグの割り当てをサポートしているかどうかを示します。 この値が false の場合、ScopeTags プロパティへの割り当ては許可されず、スコープを指定されたユーザーにエンティティが表示されません。 これは、Silverlight で作成されたレガシ ポリシーで発生し、Azure Portal でポリシーを削除して再作成することで解決できます。 このプロパティは読み取り専用です。 deviceConfiguration から継承します
deviceManagementApplicabilityRuleOsEdition deviceManagementApplicabilityRuleOsEdition このポリシーの OS エディションの適用範囲。 deviceConfiguration から継承します
deviceManagementApplicabilityRuleOsVersion deviceManagementApplicabilityRuleOsVersion このポリシーの OS バージョン適用性ルール。 deviceConfiguration から継承します
deviceManagementApplicabilityRuleDeviceMode deviceManagementApplicabilityRuleDeviceMode このポリシーのデバイス モード適用性ルール。 deviceConfiguration から継承します
createdDateTime DateTimeOffset オブジェクトが作成された DateTime。 deviceConfiguration から継承します
description String 管理者が指定した、デバイス構成についての説明。 deviceConfiguration から継承します
displayName String 管理者が指定した、デバイス構成の名前。 deviceConfiguration から継承します
version Int32 デバイス構成のバージョン。 deviceConfiguration から継承します
passwordBlockFaceUnlock ブール型 顔認証ロック解除をブロックするかどうかを示します。
passwordBlockFingerprintUnlock Boolean 指紋によるロック解除を禁止するかどうかを示します。
passwordBlockIrisUnlock ブール型 虹彩のロック解除をブロックするかどうかを指定します。
passwordBlockTrustAgents Boolean Smart Lock や他の信頼エージェントをブロックするかどうかを示します。
passwordExpirationDays Int32 パスワードの有効期限が切れるまでの日数。 有効な値は 1 から 365 までです
passwordMinimumLength Int32 パスワードの最小の長さ。 有効な値は 4 から 16 までです
passwordMinutesOfInactivityBeforeScreenTimeout Int32 画面がタイムアウトになるまでの非アクティブ時間 (分)。
passwordPreviousPasswordBlockCount Int32 ブロックする、以前のパスワードの数。 有効な値は 0 から 24 までです
passwordSignInFailureCountBeforeFactoryReset Int32 出荷時の設定にリセットされるまでの、失敗が許可されるサインインの回数。 有効な値: 1 から 16
passwordRequiredType androidForWorkRequiredPasswordType 必要なパスワードの種類。 可能な値は、deviceDefault、lowSecurityBiometric、required、atLeastNumeric、numericComplex、atLeastAlphabetic、atLeastAlphanumeric、alphanumericWithSymbols です。
requiredPasswordComplexity androidRequiredPasswordComplexity Android で必要なデバイス パスワードの複雑さを示します。 次のいずれか: なし、低、中、高。 これは、Android 12+ を対象とした新しい API です。 使用可能な値: none、low、medium、high。
workProfileDataSharingType androidForWorkCrossProfileDataSharingType 許可されるデータ共有の種類。 使用可能な値: deviceDefault、preventAny、allowPersonalToWork、noRestrictions。
workProfileBlockNotificationsWhileDeviceLocked ブール型 デバイスがロックされているときに通知をブロックするかどうかを示します。
workProfileBlockAddingAccounts ブール型 ユーザーが仕事用プロファイルでアカウントを追加/削除できないようにします。
workProfileBluetoothEnableContactSharing ブール型 Bluetooth デバイスが企業の連絡先にアクセスすることを許可します。
workProfileBlockScreenCapture ブール型 仕事用プロファイルでの画面キャプチャをブロックします。
workProfileBlockCrossProfileCallerId ブール型 個人用プロファイルでの仕事用プロファイルの発信者 ID の表示を禁止します。
workProfileBlockCamera ブール型 仕事用プロファイルのカメラをブロックします。
workProfileBlockCrossProfileContactsSearch ブール型 個人用プロファイルでの仕事用プロファイルの連絡先の可用性をブロックします。
workProfileBlockCrossProfileCopyPaste ブール型 [プロファイル間のコピー/貼り付けを禁止する] 設定が有効になっているかどうかを示すブール値。
workProfileDefaultAppPermissionPolicy androidForWorkDefaultAppPermissionPolicyType 必要なパスワードの種類。 使用可能な値: deviceDefault、prompt、autoGrant、autoDeny。
workProfilePasswordBlockFaceUnlock ブール型 仕事用プロファイルの顔認証をブロックするかどうかを示します。
workProfilePasswordBlockFingerprintUnlock ブール型 仕事用プロファイルの指紋ロック解除をブロックするかどうかを示します。
workProfilePasswordBlockIrisUnlock ブール型 仕事用プロファイルの虹彩ロック解除をブロックするかどうかを示します。
workProfilePasswordBlockTrustAgents ブール型 仕事用プロファイルの Smart Lock およびその他の信頼エージェントをブロックするかどうかを示します。
workProfilePasswordExpirationDays Int32 仕事用プロファイルのパスワードが有効期限切れになるまでの日数。 有効な値は 1 から 365 までです
workProfilePasswordMinimumLength Int32 仕事用プロファイルのパスワードの最小文字数。 有効な値は 4 から 16 までです
workProfilePasswordMinNumericCharacters Int32 仕事用プロファイルのパスワードで要求される数字の最小 # 数。 有効な値: 1 から 10
workProfilePasswordMinNonLetterCharacters Int32 仕事用プロファイルのパスワードに必要な文字以外の文字の最小 # 数。 有効な値: 1 から 10
workProfilePasswordMinLetterCharacters Int32 仕事用プロファイルのパスワードで要求される文字の最小文字数 #。 有効な値: 1 から 10
workProfilePasswordMinLowerCaseCharacters Int32 仕事用プロファイルのパスワードで要求される小文字の最小 #。 有効な値: 1 から 10
workProfilePasswordMinUpperCaseCharacters Int32 仕事用プロファイルのパスワードで要求される大文字の最小 #。 有効な値: 1 から 10
workProfilePasswordMinSymbolCharacters Int32 仕事用プロファイル パスワードに必要なシンボルの最小数 #。 有効な値: 1 から 10
workProfilePasswordMinutesOfInactivityBeforeScreenTimeout Int32 画面がタイムアウトになるまでの非アクティブ時間 (分)。
workProfilePasswordPreviousPasswordBlockCount Int32 ブロックする以前の仕事用プロファイルのパスワードの数。 有効な値は 0 から 24 までです
workProfilePasswordSignInFailureCountBeforeFactoryReset Int32 仕事用プロファイルが削除され、すべての企業データが削除されるまでに許可されたサインイン失敗の回数。 有効な値: 1 から 16
workProfilePasswordRequiredType androidForWorkRequiredPasswordType 必要な仕事用プロファイルのパスワードの種類。 可能な値は、deviceDefault、lowSecurityBiometric、required、atLeastNumeric、numericComplex、atLeastAlphabetic、atLeastAlphanumeric、alphanumericWithSymbols です。
workProfileRequiredPasswordComplexity androidRequiredPasswordComplexity Android で必要な仕事用プロファイルのパスワードの複雑さを示します。 次のいずれか: なし、低、中、高。 これは、Android 12+ を対象とした新しい API です。 使用可能な値: none、low、medium、high。
workProfileRequirePassword ブール型 仕事用プロファイルにパスワードが必要であるかどうか
securityRequireVerifyApps Boolean Android の検証アプリ機能をオンにするよう要求します。
vpnAlwaysOnPackageIdentifier 文字列 常時対応 VPN のロックダウン モードを有効にします。
vpnEnableAlwaysOnLockdownMode ブール型 常時対応 VPN のロックダウン モードを有効にします。
workProfileAllowWidgets ブール型 仕事用プロファイル アプリのウィジェットを許可します。
workProfileBlockPersonalAppInstallsFromUnknownSources ブール型 個人用プロファイルで不明なソースからのアプリのインストールを防ぎます。
workProfileAccountUse androidWorkProfileAccountUse Google アカウントを含むアカウントを仕事用プロファイルに追加するユーザーの機能を制御します。 使用可能な値: allowAllExceptGoogleAccounts、blockAll、allowAll、unknownFutureValue。
allowedGoogleAccountDomains String collection 仕事用プロファイルに追加できるアカウントのドメイン許可リストを決定します。
blockUnifiedPasswordForWorkProfile ブール型 デバイスと仕事用プロファイルのロック解除に統一されたパスワードを使用しないようにします。

応答

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

例

要求

以下は、要求の例です。

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

{
  "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFaceUnlock": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockIrisUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "requiredPasswordComplexity": "low",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFaceUnlock": true,
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockIrisUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "vpnEnableAlwaysOnLockdownMode": true,
  "workProfileAllowWidgets": true,
  "workProfileBlockPersonalAppInstallsFromUnknownSources": true,
  "workProfileAccountUse": "blockAll",
  "allowedGoogleAccountDomains": [
    "Allowed Google Account Domains value"
  ],
  "blockUnifiedPasswordForWorkProfile": true
}

応答

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

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

{
  "@odata.type": "#microsoft.graph.androidForWorkGeneralDeviceConfiguration",
  "id": "a931a366-a366-a931-66a3-31a966a331a9",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "windows10EnterpriseN"
    ],
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "Min OSVersion value",
    "maxOSVersion": "Max OSVersion value",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "sModeConfiguration",
    "name": "Name value",
    "ruleType": "exclude"
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "description": "Description value",
  "displayName": "Display Name value",
  "version": 7,
  "passwordBlockFaceUnlock": true,
  "passwordBlockFingerprintUnlock": true,
  "passwordBlockIrisUnlock": true,
  "passwordBlockTrustAgents": true,
  "passwordExpirationDays": 6,
  "passwordMinimumLength": 5,
  "passwordMinutesOfInactivityBeforeScreenTimeout": 14,
  "passwordPreviousPasswordBlockCount": 2,
  "passwordSignInFailureCountBeforeFactoryReset": 12,
  "passwordRequiredType": "lowSecurityBiometric",
  "requiredPasswordComplexity": "low",
  "workProfileDataSharingType": "preventAny",
  "workProfileBlockNotificationsWhileDeviceLocked": true,
  "workProfileBlockAddingAccounts": true,
  "workProfileBluetoothEnableContactSharing": true,
  "workProfileBlockScreenCapture": true,
  "workProfileBlockCrossProfileCallerId": true,
  "workProfileBlockCamera": true,
  "workProfileBlockCrossProfileContactsSearch": true,
  "workProfileBlockCrossProfileCopyPaste": true,
  "workProfileDefaultAppPermissionPolicy": "prompt",
  "workProfilePasswordBlockFaceUnlock": true,
  "workProfilePasswordBlockFingerprintUnlock": true,
  "workProfilePasswordBlockIrisUnlock": true,
  "workProfilePasswordBlockTrustAgents": true,
  "workProfilePasswordExpirationDays": 1,
  "workProfilePasswordMinimumLength": 0,
  "workProfilePasswordMinNumericCharacters": 7,
  "workProfilePasswordMinNonLetterCharacters": 9,
  "workProfilePasswordMinLetterCharacters": 6,
  "workProfilePasswordMinLowerCaseCharacters": 9,
  "workProfilePasswordMinUpperCaseCharacters": 9,
  "workProfilePasswordMinSymbolCharacters": 6,
  "workProfilePasswordMinutesOfInactivityBeforeScreenTimeout": 9,
  "workProfilePasswordPreviousPasswordBlockCount": 13,
  "workProfilePasswordSignInFailureCountBeforeFactoryReset": 7,
  "workProfilePasswordRequiredType": "lowSecurityBiometric",
  "workProfileRequiredPasswordComplexity": "low",
  "workProfileRequirePassword": true,
  "securityRequireVerifyApps": true,
  "vpnAlwaysOnPackageIdentifier": "Vpn Always On Package Identifier value",
  "vpnEnableAlwaysOnLockdownMode": true,
  "workProfileAllowWidgets": true,
  "workProfileBlockPersonalAppInstallsFromUnknownSources": true,
  "workProfileAccountUse": "blockAll",
  "allowedGoogleAccountDomains": [
    "Allowed Google Account Domains value"
  ],
  "blockUnifiedPasswordForWorkProfile": true
}