depIOSEnrollmentProfile を更新する
名前空間: microsoft.graph
大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。
注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。
depIOSEnrollmentProfile オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
---|---|
委任 (職場または学校のアカウント) | DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 |
アプリケーション | DeviceManagementServiceConfig.ReadWrite.All、DeviceManagementConfiguration.ReadWrite.All |
HTTP 要求
PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/defaultIosEnrollmentProfile
要求ヘッダー
ヘッダー | 値 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
承諾 | application/json |
要求本文
要求本文で、 depIOSEnrollmentProfile オブジェクトの JSON 表現を指定します。
次の表は、 depIOSEnrollmentProfile を作成するときに必要なプロパティを示しています。
プロパティ | 型 | 説明 |
---|---|---|
id | String | enrollmentProfile から継承されたオブジェクトの GUID |
displayName | String | enrollmentProfile から継承されたプロファイルの名前 |
説明 | String | enrollmentProfile から継承されたプロファイルの説明 |
requiresUserAuthentication | ブール型 | プロファイルでユーザー認証が必要かどうかを示します enrollmentProfile から継承 |
configurationEndpointUrl | String | enrollmentProfile から継承された登録に使用する構成エンドポイント URL |
enableAuthenticationViaCompanyPortal | ブール型 | ポータル サイトではなく、Apple セットアップ アシスタントで認証することを示します。 enrollmentProfile から継承された |
requireCompanyPortalOnSetupAssistantEnrolledDevices | ブール型 | 登録されたデバイスのセットアップアシスタント enrollmentProfile から継承されたポータル サイトが必要であることを示します |
isDefault | ブール型 | これが depEnrollmentBaseProfile から継承された既定のプロファイルであるかどうかを示します |
supervisedModeEnabled | ブール型 | 監視モード、有効にする場合は True、それ以外の場合は false。 詳細については、「」を参照してください https://learn.microsoft.com/intune/deploy-use/enroll-devices-in-microsoft-intune 。 depEnrollmentBaseProfile から継承される |
supportDepartment | String | depEnrollmentBaseProfile から継承されたサポート部門の情報 |
isMandatory | ブール型 | プロファイルが必須かどうかを示します depEnrollmentBaseProfile から継承 |
locationDisabled | ブール型 | 場所サービスのセットアップ ウィンドウが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
supportPhoneNumber | String | depEnrollmentBaseProfile から継承された電話番号をサポートする |
profileRemovalDisabled | ブール型 | プロファイルの削除オプションが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
restoreBlocked | ブール型 | [セットアップの復元] ウィンドウがブロックされているかどうかを示します depEnrollmentBaseProfile からの継承 |
appleIdDisabled | ブール型 | Apple ID セットアップ ウィンドウが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
termsAndConditionsDisabled | ブール型 | [使用条件] セットアップ ウィンドウが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
touchIdDisabled | ブール型 | タッチ ID セットアップ ウィンドウが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
applePayDisabled | ブール型 | Apple の支払い設定ウィンドウが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
siriDisabled | ブール型 | siri セットアップ ウィンドウが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
diagnosticsDisabled | ブール型 | 診断セットアップ ウィンドウが無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
displayToneSetupDisabled | ブール型 | displaytone セットアップ画面が無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
privacyPaneDisabled | ブール型 | プライバシー画面が無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
screenTimeScreenDisabled | ブール型 | 画面のタイムアウト設定が無効になっているかどうかを示します depEnrollmentBaseProfile から継承 |
deviceNameTemplate | String | リテラルまたは名前パターンを設定します。 depEnrollmentBaseProfile から継承される |
configurationWebUrl | ブール型 | depEnrollmentBaseProfile から継承されたログインアシスタントセットアップの URL |
enabledSkipKeys | String collection | enabledSkipKeys には、depEnrollmentBaseProfile から継承された文字列として、すべての有効なスキップ キーが含まれています |
enrollmentTimeAzureAdGroupIds | Guid コレクション | EnrollmentTimeAzureAdGroupIds には、depEnrollmentBaseProfile から継承されたプロファイルに関連付ける Azure グループ ID の登録時間の一覧が含まれています |
waitForDeviceConfiguredConfirmation | ブール型 | デバイスが depEnrollmentBaseProfile から継承された構成済みの確認を待機する必要があるかどうかを示します |
iTunesPairingMode | iTunesPairingMode | iTunes ペアリング モードを示します。 可能な値は disallow 、allow 、requiresCertificate です。 |
managementCertificates | managementCertificateWithThumbprint コレクション | Apple Configurator の管理証明書 |
restoreFromAndroidDisabled | ブール型 | Android からの復元が無効かどうかを示します |
awaitDeviceConfiguredConfirmation | ブール型 | デバイスが構成済みの確認を待機する必要があるかどうかを示します |
sharedIPadMaximumUserCount | Int32 | これは、共有 iPad を使用できるユーザーの最大数を指定します。 共有 iPad モードでのみ適用されます。 |
enableSharedIPad | ブール型 | これは、マルチ ユーザー シナリオを有効にするモードでデバイスを登録するかどうかを示します。 共有 iPad でのみ適用されます。 |
companyPortalVppTokenId | String | が設定されている場合は、デバイス ライセンスを使用してポータル サイトを展開するために使用する Vpp トークンを示します。 このプロパティを設定するには、'enableAuthenticationViaCompanyPortal' を設定する必要があります。 |
enableSingleAppEnrollmentMode | ブール型 | 1 つのアプリ モードを有効にし、登録中にアプリ ロックを適用するようにデバイスに指示します。 既定値は false です。 このプロパティを設定するには、'enableAuthenticationViaCompanyPortal' と 'companyPortalVppTokenId' を設定する必要があります。 |
homeButtonScreenDisabled | ブール型 | ホーム ボタンの秘密度画面が無効になっているかどうかを示します |
iMessageAndFaceTimeScreenDisabled | ブール型 | iMessage 画面と FaceTime 画面が無効かどうかを示します |
onBoardingScreenDisabled | ブール型 | オンボードのセットアップ画面が無効になっているかどうかを示します |
simSetupScreenDisabled | ブール型 | SIMSetup 画面が無効かどうかを示します |
softwareUpdateScreenDisabled | ブール型 | 必須のソフウェア更新画面が無効かどうかを示します |
watchMigrationScreenDisabled | ブール型 | watch移行画面が無効かどうかを示します |
appearanceScreenDisabled | ブール型 | Apperance 画面が無効かどうかを示します |
expressLanguageScreenDisabled | ブール型 | 高速言語の画面が無効になっているかどうかを示します |
preferredLanguageScreenDisabled | ブール型 | 優先言語画面が無効かどうかを示します |
deviceToDeviceMigrationDisabled | ブール型 | デバイスからデバイスへの移行が無効になっているかどうかを示します |
welcomeScreenDisabled | ブール型 | Weclome 画面が無効かどうかを示します |
passCodeDisabled | ブール型 | [パスコードの設定] ウィンドウが無効になっているかどうかを示します |
zoomDisabled | ブール型 | ズーム 設定ウィンドウが無効になっているかどうかを示します |
restoreCompletedScreenDisabled | ブール型 | Weclome 画面が無効かどうかを示します |
updateCompleteScreenDisabled | ブール型 | Weclome 画面が無効かどうかを示します |
forceTemporarySession | ブール型 | 一時的なセッションが有効かどうかを示します |
temporarySessionTimeoutInSeconds | Int32 | 一時セッションのタイムアウトを示します |
userSessionTimeoutInSeconds | Int32 | 一時セッションのタイムアウトを示します |
passcodeLockGracePeriodInSeconds | Int32 | ロックされた画面のロック解除にユーザーがデバイス passocde を入力する必要がある前にタイムアウトを示します |
carrierActivationUrl | String | デバイス eSIM をアクティブ化するためのキャリア URL。 |
userlessSharedAadModeEnabled | ブール型 | "共有デバイス モード" シナリオをサポートするために、この Apple デバイスが指定されていることを示します。 これは、"共有 iPad" シナリオとは異なります。 参照 |https://learn.microsoft.com/mem/intune/enrollment/device-enrollment-shared-ios |
応答
成功した場合、このメソッドは応答コードと更新された depIOSEnrollmentProfile オブジェクトを応答本文に返200 OK
します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/beta/deviceManagement/depOnboardingSettings/{depOnboardingSettingId}/defaultIosEnrollmentProfile
Content-type: application/json
Content-length: 2574
{
"@odata.type": "#microsoft.graph.depIOSEnrollmentProfile",
"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",
"isMandatory": true,
"locationDisabled": true,
"supportPhoneNumber": "Support Phone Number value",
"profileRemovalDisabled": true,
"restoreBlocked": true,
"appleIdDisabled": true,
"termsAndConditionsDisabled": true,
"touchIdDisabled": true,
"applePayDisabled": true,
"siriDisabled": true,
"diagnosticsDisabled": true,
"displayToneSetupDisabled": true,
"privacyPaneDisabled": true,
"screenTimeScreenDisabled": true,
"deviceNameTemplate": "Device Name Template value",
"configurationWebUrl": true,
"enabledSkipKeys": [
"Enabled Skip Keys value"
],
"enrollmentTimeAzureAdGroupIds": [
"7f64eb6c-eb6c-7f64-6ceb-647f6ceb647f"
],
"waitForDeviceConfiguredConfirmation": true,
"iTunesPairingMode": "allow",
"managementCertificates": [
{
"@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
"thumbprint": "Thumbprint value",
"certificate": "Certificate value"
}
],
"restoreFromAndroidDisabled": true,
"awaitDeviceConfiguredConfirmation": true,
"sharedIPadMaximumUserCount": 10,
"enableSharedIPad": true,
"companyPortalVppTokenId": "Company Portal Vpp Token Id value",
"enableSingleAppEnrollmentMode": true,
"homeButtonScreenDisabled": true,
"iMessageAndFaceTimeScreenDisabled": true,
"onBoardingScreenDisabled": true,
"simSetupScreenDisabled": true,
"softwareUpdateScreenDisabled": true,
"watchMigrationScreenDisabled": true,
"appearanceScreenDisabled": true,
"expressLanguageScreenDisabled": true,
"preferredLanguageScreenDisabled": true,
"deviceToDeviceMigrationDisabled": true,
"welcomeScreenDisabled": true,
"passCodeDisabled": true,
"zoomDisabled": true,
"restoreCompletedScreenDisabled": true,
"updateCompleteScreenDisabled": true,
"forceTemporarySession": true,
"temporarySessionTimeoutInSeconds": 0,
"userSessionTimeoutInSeconds": 11,
"passcodeLockGracePeriodInSeconds": 0,
"carrierActivationUrl": "https://example.com/carrierActivationUrl/",
"userlessSharedAadModeEnabled": true
}
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 2623
{
"@odata.type": "#microsoft.graph.depIOSEnrollmentProfile",
"id": "1ec10a60-0a60-1ec1-600a-c11e600ac11e",
"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",
"isMandatory": true,
"locationDisabled": true,
"supportPhoneNumber": "Support Phone Number value",
"profileRemovalDisabled": true,
"restoreBlocked": true,
"appleIdDisabled": true,
"termsAndConditionsDisabled": true,
"touchIdDisabled": true,
"applePayDisabled": true,
"siriDisabled": true,
"diagnosticsDisabled": true,
"displayToneSetupDisabled": true,
"privacyPaneDisabled": true,
"screenTimeScreenDisabled": true,
"deviceNameTemplate": "Device Name Template value",
"configurationWebUrl": true,
"enabledSkipKeys": [
"Enabled Skip Keys value"
],
"enrollmentTimeAzureAdGroupIds": [
"7f64eb6c-eb6c-7f64-6ceb-647f6ceb647f"
],
"waitForDeviceConfiguredConfirmation": true,
"iTunesPairingMode": "allow",
"managementCertificates": [
{
"@odata.type": "microsoft.graph.managementCertificateWithThumbprint",
"thumbprint": "Thumbprint value",
"certificate": "Certificate value"
}
],
"restoreFromAndroidDisabled": true,
"awaitDeviceConfiguredConfirmation": true,
"sharedIPadMaximumUserCount": 10,
"enableSharedIPad": true,
"companyPortalVppTokenId": "Company Portal Vpp Token Id value",
"enableSingleAppEnrollmentMode": true,
"homeButtonScreenDisabled": true,
"iMessageAndFaceTimeScreenDisabled": true,
"onBoardingScreenDisabled": true,
"simSetupScreenDisabled": true,
"softwareUpdateScreenDisabled": true,
"watchMigrationScreenDisabled": true,
"appearanceScreenDisabled": true,
"expressLanguageScreenDisabled": true,
"preferredLanguageScreenDisabled": true,
"deviceToDeviceMigrationDisabled": true,
"welcomeScreenDisabled": true,
"passCodeDisabled": true,
"zoomDisabled": true,
"restoreCompletedScreenDisabled": true,
"updateCompleteScreenDisabled": true,
"forceTemporarySession": true,
"temporarySessionTimeoutInSeconds": 0,
"userSessionTimeoutInSeconds": 11,
"passcodeLockGracePeriodInSeconds": 0,
"carrierActivationUrl": "https://example.com/carrierActivationUrl/",
"userlessSharedAadModeEnabled": true
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示