depEnrollmentProfile を作成する
名前空間: microsoft.graph
大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
新しい depEnrollmentProfile オブジェクトを 作成します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All |
HTTP 要求
POST /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
| 承諾 | application/json |
要求本文
要求本文で、depEnrollmentProfile オブジェクトの JSON 表現を指定します。
次の表は、depEnrollmentProfile を作成するときに必要なプロパティを示しています。
| プロパティ | 型 | 説明 |
|---|---|---|
| id | String | enrollmentProfile から継承されたオブジェクトの GUID |
| displayName | String | enrollmentProfile から継承されたプロファイルの名前 |
| 説明 | String | enrollmentProfile から継承されたプロファイルの説明 |
| requiresUserAuthentication | ブール型 | プロファイルでユーザー認証が必要かどうかを示します enrollmentProfile から継承 |
| configurationEndpointUrl | String | enrollmentProfile から継承された登録に使用する構成エンドポイント URL |
| enableAuthenticationViaCompanyPortal | ブール型 | ポータル サイトではなく、Apple セットアップ アシスタントで認証することを示します。 enrollmentProfile から継承された |
| requireCompanyPortalOnSetupAssistantEnrolledDevices | ブール型 | 登録されたデバイスのセットアップアシスタント enrollmentProfile から継承されたポータル サイトが必要であることを示します |
| isDefault | ブール型 | これが既定のプロファイルであるかどうかを示します |
| supervisedModeEnabled | ブール型 | 監視モード、有効にする場合は True、それ以外の場合は false。 詳細については、「」を参照してください https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune 。 |
| supportDepartment | String | サポート部門の情報 |
| passCodeDisabled | ブール型 | [パスコードの設定] ウィンドウが無効になっているかどうかを示します |
| isMandatory | ブール型 | プロファイルが必須かどうかを示します |
| locationDisabled | ブール型 | [場所サービスのセットアップ] ウィンドウが無効になっているかどうかを示します |
| supportPhoneNumber | String | サポート電話番号 |
| iTunesPairingMode | iTunesPairingMode | iTunes ペアリング モードを示します。 可能な値は disallow、allow、requiresCertificate です。 |
| profileRemovalDisabled | ブール型 | プロファイルの削除オプションが無効かどうかを示します |
| managementCertificates | managementCertificateWithThumbprint コレクション | Apple Configurator の管理証明書 |
| restoreBlocked | ブール型 | [セットアップの復元] ウィンドウがブロックされているかどうかを示します |
| restoreFromAndroidDisabled | ブール型 | Android からの復元が無効かどうかを示します |
| appleIdDisabled | ブール型 | Apple ID セットアップ ウィンドウが無効になっているかどうかを示します |
| termsAndConditionsDisabled | ブール型 | [使用条件] 設定ウィンドウが無効になっているかどうかを示します |
| touchIdDisabled | ブール型 | タッチ ID の設定ウィンドウが無効になっているかどうかを示します |
| applePayDisabled | ブール型 | Apple の [支払い設定] ウィンドウが無効になっているかどうかを示します |
| zoomDisabled | ブール型 | ズーム 設定ウィンドウが無効になっているかどうかを示します |
| siriDisabled | ブール型 | Siri セットアップ ウィンドウが無効になっているかどうかを示します |
| diagnosticsDisabled | ブール型 | 診断セットアップ ウィンドウが無効になっているかどうかを示します |
| macOSRegistrationDisabled | ブール型 | Mac OS の登録が無効かどうかを示します |
| macOSFileVaultDisabled | ブール型 | Mac OS ファイル コンテナーが無効かどうかを示します |
| awaitDeviceConfiguredConfirmation | ブール型 | デバイスが構成済みの確認を待機する必要があるかどうかを示します |
| sharedIPadMaximumUserCount | Int32 | これは、共有 iPad を使用できるユーザーの最大数を指定します。 共有 iPad モードでのみ適用されます。 |
| enableSharedIPad | ブール型 | これは、マルチ ユーザー シナリオを有効にするモードでデバイスを登録するかどうかを示します。 共有 iPad でのみ適用されます。 |
応答
成功した場合、このメソッドは 201 Created 応答コードと、応答本文の depEnrollmentProfile オブジェクトを返します。
例
要求
以下は、要求の例です。
POST https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/enrollmentProfiles
Content-type: application/json
Content-length: 1354
{
"@odata.type": "#microsoft.graph.depEnrollmentProfile",
"displayName": "Display Name value",
"description": "Description value",
"requiresUserAuthentication": true,
"configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
"enableAuthenticationViaCompanyPortal": true,
"requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
"isDefault": true,
"supervisedModeEnabled": true,
"supportDepartment": "Support Department value",
"passCodeDisabled": true,
"isMandatory": true,
"locationDisabled": true,
"supportPhoneNumber": "Support Phone Number value",
"iTunesPairingMode": "allow",
"profileRemovalDisabled": true,
"managementCertificates": [
{
"@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
"thumbprint": "Thumbprint value",
"certificate": "Certificate value"
}
],
"restoreBlocked": true,
"restoreFromAndroidDisabled": true,
"appleIdDisabled": true,
"termsAndConditionsDisabled": true,
"touchIdDisabled": true,
"applePayDisabled": true,
"zoomDisabled": true,
"siriDisabled": true,
"diagnosticsDisabled": true,
"macOSRegistrationDisabled": true,
"macOSFileVaultDisabled": true,
"awaitDeviceConfiguredConfirmation": true,
"sharedIPadMaximumUserCount": 10,
"enableSharedIPad": true
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1403
{
"@odata.type": "#microsoft.graph.depEnrollmentProfile",
"id": "3d4534f7-34f7-3d45-f734-453df734453d",
"displayName": "Display Name value",
"description": "Description value",
"requiresUserAuthentication": true,
"configurationEndpointUrl": "https://example.com/configurationEndpointUrl/",
"enableAuthenticationViaCompanyPortal": true,
"requireCompanyPortalOnSetupAssistantEnrolledDevices": true,
"isDefault": true,
"supervisedModeEnabled": true,
"supportDepartment": "Support Department value",
"passCodeDisabled": true,
"isMandatory": true,
"locationDisabled": true,
"supportPhoneNumber": "Support Phone Number value",
"iTunesPairingMode": "allow",
"profileRemovalDisabled": true,
"managementCertificates": [
{
"@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
"thumbprint": "Thumbprint value",
"certificate": "Certificate value"
}
],
"restoreBlocked": true,
"restoreFromAndroidDisabled": true,
"appleIdDisabled": true,
"termsAndConditionsDisabled": true,
"touchIdDisabled": true,
"applePayDisabled": true,
"zoomDisabled": true,
"siriDisabled": true,
"diagnosticsDisabled": true,
"macOSRegistrationDisabled": true,
"macOSFileVaultDisabled": true,
"awaitDeviceConfiguredConfirmation": true,
"sharedIPadMaximumUserCount": 10,
"enableSharedIPad": true
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示