Update iosManagedAppProtectionUpdate iosManagedAppProtection

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

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

iosManagedAppProtection オブジェクトのプロパティを更新します。Update the properties of a iosManagedAppProtection object.

前提条件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) DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication DeviceManagementApps.ReadWrite.AllDeviceManagementApps.ReadWrite.All

HTTP 要求HTTP Request

PATCH /deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}

要求ヘッダーRequest headers

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

要求本文Request body

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

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

プロパティProperty 種類Type 説明Description
displayNamedisplayName 文字列String ポリシーの表示名。Policy display name. managedAppPolicy から継承しますInherited from managedAppPolicy
説明description StringString ポリシーの説明。The policy's description. managedAppPolicy から継承しますInherited from managedAppPolicy
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset ポリシーが作成された日時。The date and time the policy was created. managedAppPolicy から継承しますInherited from managedAppPolicy
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset ポリシーが変更された最終日時。Last time the policy was modified. managedAppPolicy から継承しますInherited from managedAppPolicy
idid 文字列String エンティティのキー。Key of the entity. managedAppPolicy から継承しますInherited from managedAppPolicy
versionversion StringString エンティティのバージョン。Version of the entity. managedAppPolicy から継承しますInherited from managedAppPolicy
periodOfflineBeforeAccessCheckperiodOfflineBeforeAccessCheck DurationDuration デバイスがインターネットに接続されていないでこの期間が過ぎると、アクセスがチェックされます。The period after which access is checked when the device is not connected to the internet. managedAppProtection から継承しますInherited from managedAppProtection
periodOnlineBeforeAccessCheckperiodOnlineBeforeAccessCheck DurationDuration デバイスがインターネットに接続されていてこの期間が過ぎると、アクセスがチェックされます。The period after which access is checked when the device is connected to the internet. managedAppProtection から継承しますInherited from managedAppProtection
allowedInboundDataTransferSourcesallowedInboundDataTransferSources ManagedappdatatransフェリーレベルmanagedAppDataTransferLevel データの転送が許可されたソース。Sources from which data is allowed to be transferred. Managedappprotectionから継承します。Inherited from managedAppProtection. 可能な値は、allAppsmanagedAppsnone です。Possible values are: allApps, managedApps, none.
allowedOutboundDataTransferDestinationsallowedOutboundDataTransferDestinations ManagedappdatatransフェリーレベルmanagedAppDataTransferLevel データの転送が許可された宛先。Destinations to which data is allowed to be transferred. Managedappprotectionから継承します。Inherited from managedAppProtection. 可能な値は、allAppsmanagedAppsnone です。Possible values are: allApps, managedApps, none.
organizationalCredentialsRequiredorganizationalCredentialsRequired BooleanBoolean アプリを使用するために組織の資格情報が必要かどうかを示します。Indicates whether organizational credentials are required for app use. managedAppProtection から継承しますInherited from managedAppProtection
allowedOutboundClipboardSharingLevelallowedOutboundClipboardSharingLevel Managedappクリップボードの SharinglevelmanagedAppClipboardSharingLevel 管理対象デバイスで、アプリ間でクリップボードを共有できるレベル。The level to which the clipboard may be shared between apps on the managed device. Managedappprotectionから継承します。Inherited from managedAppProtection. 可能な値は、allAppsmanagedAppsWithPasteInmanagedAppsblocked です。Possible values are: allApps, managedAppsWithPasteIn, managedApps, blocked.
dataBackupBlockeddataBackupBlocked BooleanBoolean 管理対象アプリのデータのバックアップがブロックされるかどうかを示します。Indicates whether the backup of a managed app's data is blocked. managedAppProtection から継承しますInherited from managedAppProtection
deviceComplianceRequireddeviceComplianceRequired BooleanBoolean デバイスの準拠が必要かどうかを示します。Indicates whether device compliance is required. managedAppProtection から継承しますInherited from managedAppProtection
managedBrowserToOpenLinksRequiredmanagedBrowserToOpenLinksRequired BooleanBoolean 管理ブラウザーアプリでインターネットリンクを開くか、CustomBrowserProtocol (iOS 用) または CustomBrowserPackageId/Custombrowserprotocol (for Android) で指定したカスタムブラウザーをManagedappprotectionから継承するかどうかを示しますIndicates whether internet links should be opened in the managed browser app, or any custom browser specified by CustomBrowserProtocol (for iOS) or CustomBrowserPackageId/CustomBrowserDisplayName (for Android) Inherited from managedAppProtection
saveAsBlockedsaveAsBlocked BooleanBoolean ユーザーが保護されたファイルのコピーを保存するために、[名前を付けて保存] メニュー項目を使用できるかどうかを示します。Indicates whether users may use the "Save As" menu item to save a copy of protected files. managedAppProtection から継承しますInherited from managedAppProtection
periodOfflineBeforeWipeIsEnforcedperiodOfflineBeforeWipeIsEnforced DurationDuration アプリがインターネットから切断されている状態を維持できる時間数。この時間を過ぎると管理対象データはすべて消去されます。The amount of time an app is allowed to remain disconnected from the internet before all managed data it is wiped. managedAppProtection から継承しますInherited from managedAppProtection
pinRequiredpinRequired BooleanBoolean アプリ レベルの pin が必要かどうかを示します。Indicates whether an app-level pin is required. managedAppProtection から継承しますInherited from managedAppProtection
maximumPinRetriesmaximumPinRetries Int32Int32 管理対象アプリがブロックまたはワイプされるまでの、正しくない pin の再試行回数の最大数。Maximum number of incorrect pin retry attempts before the managed app is either blocked or wiped. managedAppProtection から継承しますInherited from managedAppProtection
simplePinBlockedsimplePinBlocked BooleanBoolean simplePin がブロックされるかどうかを示します。Indicates whether simplePin is blocked. managedAppProtection から継承しますInherited from managedAppProtection
minimumPinLengthminimumPinLength Int32Int32 PinRequired が True に設定されている場合の、アプリ レベルの pin に必要な最小限の pin の長さ (managedAppProtection から継承)Minimum pin length required for an app-level pin if PinRequired is set to True Inherited from managedAppProtection
pinCharacterSetpinCharacterSet managedAppPinCharacterSetmanagedAppPinCharacterSet PinRequired が True に設定されている場合に、アプリ レベルの pin に使用できる文字セット。Character set which may be used for an app-level pin if PinRequired is set to True. Managedappprotectionから継承します。Inherited from managedAppProtection. 可能な値は、numericalphanumericAndSymbol です。Possible values are: numeric, alphanumericAndSymbol.
periodBeforePinResetperiodBeforePinReset DurationDuration PinRequired が True に設定されている場合、この TimePeriod を過ぎると全レベルの pin を再設定する必要があります。TimePeriod before the all-level pin must be reset if PinRequired is set to True. managedAppProtection から継承しますInherited from managedAppProtection
allowedDataStorageLocationsallowedDataStorageLocations Managedappdatastoragelocation コレクションmanagedAppDataStorageLocation collection ユーザーが管理対象データを格納できるデータの保存場所。Data storage locations where a user may store managed data. Managedappprotectionから継承します。Inherited from managedAppProtection. 可能な値は、oneDriveForBusinesssharePointlocalStorage です。Possible values are: oneDriveForBusiness, sharePoint, localStorage.
contactSyncBlockedcontactSyncBlocked BooleanBoolean 連絡先をユーザー デバイスに同期できるかどうかを示します。Indicates whether contacts can be synced to the user's device. managedAppProtection から継承しますInherited from managedAppProtection
printBlockedprintBlocked BooleanBoolean 管理対象アプリからの印刷を許可するかどうかを示します。Indicates whether printing is allowed from managed apps. managedAppProtection から継承しますInherited from managedAppProtection
fingerprintBlockedfingerprintBlocked BooleanBoolean PinRequired が True に設定されている場合に、pin の代わりに指紋リーダーの使用を許可するかどうかを示します。Indicates whether use of the fingerprint reader is allowed in place of a pin if PinRequired is set to True. managedAppProtection から継承しますInherited from managedAppProtection
disableAppPinIfDevicePinIsSetdisableAppPinIfDevicePinIsSet BooleanBoolean デバイスの pin が設定されている場合に、アプリの pin の使用が必要かどうかを示します。Indicates whether use of the app pin is required if the device pin is set. managedAppProtection から継承しますInherited from managedAppProtection
minimumRequiredOsVersionminimumRequiredOsVersion StringString バージョンが、指定されたバージョンよりも小さい場合に、管理対象アプリによる会社のデータへのアクセスをブロックします。Versions less than the specified version will block the managed app from accessing company data. managedAppProtection から継承しますInherited from managedAppProtection
minimumWarningOsVersionminimumWarningOsVersion StringString OS のバージョンが、指定されたバージョンよりも小さい場合に、会社のデータへアクセスすると管理対象アプリに警告メッセージが表示されます。Versions less than the specified version will result in warning message on the managed app from accessing company data. managedAppProtection から継承しますInherited from managedAppProtection
minimumRequiredAppVersionminimumRequiredAppVersion StringString バージョンが、指定されたバージョンよりも小さい場合に、管理対象アプリによる会社のデータへのアクセスをブロックします。Versions less than the specified version will block the managed app from accessing company data. managedAppProtection から継承しますInherited from managedAppProtection
minimumWarningAppVersionminimumWarningAppVersion StringString アプリのバージョンが、指定されたバージョンよりも小さい場合に、管理対象アプリに警告メッセージが表示されます。Versions less than the specified version will result in warning message on the managed app. managedAppProtection から継承しますInherited from managedAppProtection
managedBrowsermanagedBrowser managedBrowserTypemanagedBrowserType インターネットリンクを開く必要がある managed browser を示します。Indicates in which managed browser(s) that internet links should be opened. このプロパティを構成する場合、ManagedBrowserToOpenLinksRequired は true である必要があります。When this property is configured, ManagedBrowserToOpenLinksRequired should be true. Managedappprotectionから継承します。Inherited from managedAppProtection. 可能な値は、notConfiguredmicrosoftEdge です。Possible values are: notConfigured, microsoftEdge.
isAssignedisAssigned BooleanBoolean 包含グループにポリシーを配置するかどうかを示します。Indicates if the policy is deployed to any inclusion groups or not. targetedManagedAppProtection から継承しますInherited from targetedManagedAppProtection
appDataEncryptionTypeappDataEncryptionType managedAppDataEncryptionTypemanagedAppDataEncryptionType 管理対象アプリのデータに使用する暗号化の種類。Type of encryption which should be used for data in a managed app. 可能な値は、useDeviceSettingsafterDeviceRestartwhenDeviceLockedExceptOpenFileswhenDeviceLocked です。Possible values are: useDeviceSettings, afterDeviceRestart, whenDeviceLockedExceptOpenFiles, whenDeviceLocked.
minimumRequiredSdkVersionminimumRequiredSdkVersion StringString バージョンが、指定されたバージョンよりも小さい場合に、管理対象アプリによる会社のデータへのアクセスをブロックします。Versions less than the specified version will block the managed app from accessing company data.
deployedAppCountdeployedAppCount Int32Int32 現在のポリシーが配置されたアプリの数。Count of apps to which the current policy is deployed.
faceIdBlockedfaceIdBlocked BooleanBoolean PinRequired が True に設定されている場合に、pin の代わりに FaceID の使用を許可するかどうかを示します。Indicates whether use of the FaceID is allowed in place of a pin if PinRequired is set to True.
customBrowserProtocolcustomBrowserProtocol 文字列String IOS で microsoft.rtc.management.writeableconfig.settings.weblink.weblink を開くためのカスタムブラウザープロトコル。A custom browser protocol to open weblink on iOS. このプロパティを構成する場合、ManagedBrowserToOpenLinksRequired は true である必要があります。When this property is configured, ManagedBrowserToOpenLinksRequired should be true.

応答Response

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

Example

要求Request

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

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/iosManagedAppProtections/{iosManagedAppProtectionId}
Content-type: application/json
Content-length: 1667

{
  "@odata.type": "#microsoft.graph.iosManagedAppProtection",
  "displayName": "Display Name value",
  "description": "Description value",
  "version": "Version value",
  "periodOfflineBeforeAccessCheck": "-PT17.1357909S",
  "periodOnlineBeforeAccessCheck": "PT35.0018757S",
  "allowedInboundDataTransferSources": "managedApps",
  "allowedOutboundDataTransferDestinations": "managedApps",
  "organizationalCredentialsRequired": true,
  "allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
  "dataBackupBlocked": true,
  "deviceComplianceRequired": true,
  "managedBrowserToOpenLinksRequired": true,
  "saveAsBlocked": true,
  "periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
  "pinRequired": true,
  "maximumPinRetries": 1,
  "simplePinBlocked": true,
  "minimumPinLength": 0,
  "pinCharacterSet": "alphanumericAndSymbol",
  "periodBeforePinReset": "PT3M29.6631862S",
  "allowedDataStorageLocations": [
    "sharePoint"
  ],
  "contactSyncBlocked": true,
  "printBlocked": true,
  "fingerprintBlocked": true,
  "disableAppPinIfDevicePinIsSet": true,
  "minimumRequiredOsVersion": "Minimum Required Os Version value",
  "minimumWarningOsVersion": "Minimum Warning Os Version value",
  "minimumRequiredAppVersion": "Minimum Required App Version value",
  "minimumWarningAppVersion": "Minimum Warning App Version value",
  "managedBrowser": "microsoftEdge",
  "isAssigned": true,
  "appDataEncryptionType": "afterDeviceRestart",
  "minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
  "deployedAppCount": 0,
  "faceIdBlocked": true,
  "customBrowserProtocol": "Custom Browser Protocol 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 200 OK
Content-Type: application/json
Content-Length: 1839

{
  "@odata.type": "#microsoft.graph.iosManagedAppProtection",
  "displayName": "Display Name value",
  "description": "Description value",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "id": "5bc789cb-89cb-5bc7-cb89-c75bcb89c75b",
  "version": "Version value",
  "periodOfflineBeforeAccessCheck": "-PT17.1357909S",
  "periodOnlineBeforeAccessCheck": "PT35.0018757S",
  "allowedInboundDataTransferSources": "managedApps",
  "allowedOutboundDataTransferDestinations": "managedApps",
  "organizationalCredentialsRequired": true,
  "allowedOutboundClipboardSharingLevel": "managedAppsWithPasteIn",
  "dataBackupBlocked": true,
  "deviceComplianceRequired": true,
  "managedBrowserToOpenLinksRequired": true,
  "saveAsBlocked": true,
  "periodOfflineBeforeWipeIsEnforced": "-PT3M22.1587532S",
  "pinRequired": true,
  "maximumPinRetries": 1,
  "simplePinBlocked": true,
  "minimumPinLength": 0,
  "pinCharacterSet": "alphanumericAndSymbol",
  "periodBeforePinReset": "PT3M29.6631862S",
  "allowedDataStorageLocations": [
    "sharePoint"
  ],
  "contactSyncBlocked": true,
  "printBlocked": true,
  "fingerprintBlocked": true,
  "disableAppPinIfDevicePinIsSet": true,
  "minimumRequiredOsVersion": "Minimum Required Os Version value",
  "minimumWarningOsVersion": "Minimum Warning Os Version value",
  "minimumRequiredAppVersion": "Minimum Required App Version value",
  "minimumWarningAppVersion": "Minimum Warning App Version value",
  "managedBrowser": "microsoftEdge",
  "isAssigned": true,
  "appDataEncryptionType": "afterDeviceRestart",
  "minimumRequiredSdkVersion": "Minimum Required Sdk Version value",
  "deployedAppCount": 0,
  "faceIdBlocked": true,
  "customBrowserProtocol": "Custom Browser Protocol value"
}