managedDevice の更新

[アーティクル]
10/25/2023

名前空間: microsoft.graph

大事な： /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。

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

managedDevice オブジェクトのプロパティを更新します。

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

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

アクセス許可

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

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

HTTP 要求

PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/comanagedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}

要求ヘッダー

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

要求本文

要求本文で、managedDevice オブジェクトの JSON 表記を指定します。

次の表に、managedDevice の作成時に必要なプロパティを示します。

プロパティ	型	説明
id	String	デバイスの一意識別子。このプロパティは読み取り専用です。
userId	String	デバイスに関連付けられているユーザーの一意識別子。このプロパティは読み取り専用です。
deviceName	String	デバイスの名前。このプロパティは読み取り専用です。
hardwareInformation	hardwareInformation	デバイスの難しい詳細。ストレージ領域、製造元、シリアル番号などの情報が含まれます。既定では、この型のほとんどのプロパティは null/0/false に設定され、列挙型の既定値は関連付けられている型です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。サポート: $select。 $Searchはサポートされていません。読み取り専用です。このプロパティは読み取り専用です。
ownerType	ownerType	デバイスの所有権。使用可能な値は、'company' または 'personal' です。既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。可能な値は `unknown`、`company`、`personal` です。
managedDeviceOwnerType	managedDeviceOwnerType	デバイスの所有権。 "会社" または "個人用" にすることができます。可能な値は `unknown`、`company`、`personal` です。
deviceActionResults	deviceActionResult コレクション	ComplexType deviceActionResult オブジェクトのリスト。このプロパティは読み取り専用です。
managementState	managementState	デバイスの管理状態。例: Managed、RetirePending など。既定値はマネージドです。 $filter演算子 'eq' と 'or' をサポートします。このプロパティは読み取り専用です。可能な値は、`managed`、`retirePending`、`retireFailed`、`wipePending`、`wipeFailed`、`unhealthy`、`deletePending`、`retireIssued`、`wipeIssued`、`wipeCanceled`、`retireCanceled`、`discovered` です。
enrolledDateTime	DateTimeOffset	デバイスの登録時刻。 $filter演算子 'lt' と 'gt' をサポートします。このプロパティは読み取り専用です。
lastSyncDateTime	DateTimeOffset	デバイスが Intune との正常な同期を最終的に完了した日時。 $filter演算子 'lt' と 'gt' をサポートします。このプロパティは読み取り専用です。
chassisType	chassisType	デバイスのシャーシの種類。このプロパティは読み取り専用です。可能な値は、`unknown`、`desktop`、`laptop`、`worksWorkstation`、`enterpriseServer`、`phone`、`tablet`、`mobileOther`、`mobileUnknown` です。
operatingSystem	String	デバイスのオペレーティングシステム。 Windows、iOS などこのプロパティは読み取り専用です。
deviceType	deviceType	デバイスのプラットフォーム。例: デスクトップ、WindowsRT など既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。このプロパティは読み取り専用です。使用可能な値は、 `desktop`、 `windowsRT`、 `winMO6`、 `nokia`、 `windowsPhone`、 `mac`、 `winCE`、 `winEmbedded`、 `iPhone`、 `iPad`、 `iPod`、 `android`、 `iSocConsumer`、 `unix`、 `macMDM`、 `holoLens`、 `surfaceHub`、 `androidForWork`、 `androidEnterprise`、 `windows10x`、 `androidnGMS`、 `chromeOS`、 `linux`、 `blackberry`、 `palm`、 `unknown`、 `cloudPC`。
complianceState	complianceState	デバイスのコンプライアンス状態。例: 準拠、競合、エラーなど既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。このプロパティは読み取り専用です。可能な値は、`unknown`、`compliant`、`noncompliant`、`conflict`、`error`、`inGracePeriod`、`configManager` です。
jailBroken	String	デバイスが脱獄されているか、ルート化されているか。既定値は空の文字列です。 $filter演算子 'eq' と 'or' をサポートします。このプロパティは読み取り専用です。
managementAgent	managementAgentType	デバイスの管理チャネル。例: Intune、EAS など既定値は不明です。 $filter演算子 'eq' と 'or' をサポートします。このプロパティは読み取り専用です。可能な値は、`eas`、`mdm`、`easMdm`、`intuneClient`、`easIntuneClient`、`configurationManagerClient`、`configurationManagerClientMdm`、`configurationManagerClientMdmEas`、`unknown`、`jamf`、`googleCloudDevicePolicyController`、`microsoft365ManagedMdm`、`msSense`、`intuneAosp`、`google`、`unknownFutureValue` です。
osVersion	String	デバイスのオペレーティングシステムのバージョン。このプロパティは読み取り専用です。
easActivated	Boolean	Exchange ActiveSync がアクティブになっているデバイスかどうかを示します。このプロパティは読み取り専用です。
easDeviceId	String	デバイスの Exchange ActiveSync の ID。このプロパティは読み取り専用です。
easActivationDateTime	DateTimeOffset	デバイスの Exchange ActivationSync のアクティブ化の時刻。このプロパティは読み取り専用です。
aadRegistered	ブール型	Azure Active Directory が登録されているデバイスかどうかを示します。このプロパティは読み取り専用です。
azureADRegistered	Boolean	Azure Active Directory が登録されているデバイスかどうかを示します。このプロパティは読み取り専用です。
deviceEnrollmentType	deviceEnrollmentType	デバイスの登録の種類。このプロパティは読み取り専用です。使用できる値は、 `unknown`、 `userEnrollment`、 `deviceEnrollmentManager`、 `appleBulkWithUser`、 `appleBulkWithoutUser`、 `windowsAzureADJoin`、 `windowsBulkUserless`、 `windowsAutoEnrollmentwindowsBulkAzureDomainJoin`、 `windowsCoManagement`、 `windowsAzureADJoinUsingDeviceAuth`、 `appleUserEnrollment`、 `appleUserEnrollmentWithServiceAccount`、 `azureAdJoinUsingAzureVmExtension`、 `androidEnterpriseDedicatedDevice`、 `androidEnterpriseFullyManaged`、 `androidEnterpriseCorporateWorkProfile`、 `appleACMEBasicBYOD`、 `appleACMEDEPUserless`、 `appleACMEDEPUDACompanyPortal`、 `appleACMEDEPUDASetupAsstLegacy`、 `appleACMEDEPUDAModernAuth`です。
lostModeState	lostModeState	失われたモードが有効か無効か示します。このプロパティは読み取り専用です。可能な値は、`disabled`、`enabled` です。
activationLockBypassCode	String	マネージドデバイスのアクティブ化ロックをバイパスできるようにするコード。 LIST 呼び出しで managedDevice エンティティの一部として返される場合、このプロパティの既定値は Null (既定値以外のプロパティ) です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。サポート: $select。 $Searchはサポートされていません。読み取り専用です。このプロパティは読み取り専用です。
emailAddress	String	デバイスに関連付けられているユーザーの電子メール。このプロパティは読み取り専用です。
azureActiveDirectoryDeviceId	String	Azure Active Directory デバイスの一意識別子。読み取り専用です。このプロパティは読み取り専用です。
azureADDeviceId	String	Azure Active Directory デバイスの一意識別子。読み取り専用です。このプロパティは読み取り専用です。
deviceRegistrationState	deviceRegistrationState	デバイスの登録状態。このプロパティは読み取り専用です。可能な値は、`notRegistered`、`registered`、`revoked`、`keyConflict`、`approvalPending`、`certificateReset`、`notRegisteredPendingEnrollment`、`unknown` です。
deviceCategoryDisplayName	String	デバイスカテゴリの表示名。既定値は空の文字列です。 $filter演算子 'eq' と 'or' をサポートします。このプロパティは読み取り専用です。
isSupervised	ブール型	デバイス監視状態。このプロパティは読み取り専用です。
exchangeLastSuccessfulSyncDateTime	DateTimeOffset	最後にデバイスが Exchange に接続した時刻。このプロパティは読み取り専用です。
exchangeAccessState	deviceManagementExchangeAccessState	Exchange でのデバイスのアクセスの状態。このプロパティは読み取り専用です。可能な値は、`none`、`unknown`、`allowed`、`blocked`、`quarantined` です。
exchangeAccessStateReason	deviceManagementExchangeAccessStateReason	Exchange でのデバイスのアクセス状態の理由。このプロパティは読み取り専用です。可能な値は、`none`、`unknown`、`exchangeGlobalRule`、`exchangeIndividualRule`、`exchangeDeviceRule`、`exchangeUpgrade`、`exchangeMailboxPolicy`、`other`、`compliant`、`notCompliant`、`notEnrolled`、`unknownLocation`、`mfaRequired`、`azureADBlockDueToAccessPolicy`、`compromisedPassword`、`deviceNotKnownWithManagedApp` です。
remoteAssistanceSessionUrl	String	デバイスとのリモートアシスタンスセッションを確立できるようにする URL。既定値は空の文字列です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。このプロパティは読み取り専用です。
remoteAssistanceSessionErrorDetails	String	リモートアシスタンスセッションオブジェクトの作成時に問題を識別するエラー文字列。このプロパティは読み取り専用です。
isEncrypted	ブール型	デバイス暗号化の状態。このプロパティは読み取り専用です。
userPrincipalName	String	デバイスユーザープリンシパル名。このプロパティは読み取り専用です。
model	String	デバイスのモデル。このプロパティは読み取り専用です。
manufacturer	String	デバイスの製造元。このプロパティは読み取り専用です。
imei	String	IMEI。このプロパティは読み取り専用です。
complianceGracePeriodExpirationDateTime	DateTimeOffset	デバイスコンプライアンスの猶予期間の有効期限が切れる DateTime。このプロパティは読み取り専用です。
シリアル番号	String	SerialNumber。このプロパティは読み取り専用です。
phoneNumber	String	デバイスの電話番号。このプロパティは読み取り専用です。
androidSecurityPatchLevel	String	Android セキュリティパッチレベル。このプロパティは読み取り専用です。
userDisplayName	String	ユーザー表示名。このプロパティは読み取り専用です。
configurationManagerClientEnabledFeatures	configurationManagerClientEnabledFeatures	ConfigrMgr クライアントが有効な機能。このプロパティは読み取り専用です。
wiFiMacAddress	String	MAC を Wi-Fi します。このプロパティは読み取り専用です。
deviceHealthAttestationState	deviceHealthAttestationState	デバイスの正常性構成証明の状態。このプロパティは読み取り専用です。
subscriberCarrier	String	サブスクライバーの通信事業者。このプロパティは読み取り専用です。
meid	String	MEID。このプロパティは読み取り専用です。
totalStorageSpaceInBytes	Int64	ストレージの合計 (バイト単位)。このプロパティは読み取り専用です。
freeStorageSpaceInBytes	Int64	Free Storage (バイト単位)。既定値は 0 です。読み取り専用です。このプロパティは読み取り専用です。
managedDeviceName	String	デバイスを識別する名前が自動的に生成されます。ユーザーフレンドリ名に上書きできます。
partnerReportedThreatState	managedDevicePartnerReportedHealthState	Mobile Threat Defense パートナーがアカウントおよびデバイスで使用されている場合の、デバイスの脅威の状態を示します。読み取り専用です。このプロパティは読み取り専用です。可能な値は、`unknown`、`activated`、`deactivated`、`secured`、`lowSeverity`、`mediumSeverity`、`highSeverity`、`unresponsive`、`compromised`、`misconfigured` です。
retireAfterDateTime	DateTimeOffset	スケジュールされたアクションのためにデバイスが自動廃止される時刻を示します。このプロパティは読み取り専用です。
usersLoggedOn	loggedOnUser コレクション	デバイスの最後にログオンしたユーザーを示します。このプロパティは読み取り専用です。
preferMdmOverGroupPolicyAppliedDateTime	DateTimeOffset	preferMdmOverGroupPolicy 設定が設定された DateTime を報告します。設定すると、競合が発生した場合、Intune MDM 設定によってグループポリシー設定がオーバーライドされます。読み取り専用です。このプロパティは読み取り専用です。
autopilotEnrolled	ブール型	マネージドデバイスが自動パイロット経由で登録されているかどうかを報告します。このプロパティは読み取り専用です。
requireUserEnrollmentApproval	ブール型	管理対象の iOS デバイスがユーザー承認登録であるかどうかを報告します。このプロパティは読み取り専用です。
managementCertificateExpirationDate	DateTimeOffset	デバイス管理証明書の有効期限を報告します。このプロパティは読み取り専用です。
iccid	String	IC カード識別子は、SIM カードの一意の識別番号です。既定値は空の文字列です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。サポート: $select。 $Searchはサポートされていません。読み取り専用です。このプロパティは読み取り専用です。
udid	String	iOS デバイスと macOS デバイスの一意のデバイス識別子。既定値は空の文字列です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。サポート: $select。 $Searchはサポートされていません。読み取り専用です。このプロパティは読み取り専用です。
roleScopeTagIds	String collection	このデバイスインスタンスのスコープタグ ID の一覧。
windowsActiveMalwareCount	Int32	この Windows デバイスのアクティブなマルウェアの数。既定値は 0 です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。このプロパティは読み取り専用です。
windowsRemediatedMalwareCount	Int32	この Windows デバイスの修復されたマルウェアの数。既定値は 0 です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。このプロパティは読み取り専用です。
notes	String	IT 管理者によって作成されたデバイスに関するメモ。既定値は null です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。サポート: $select。 $Searchはサポートされていません。
configurationManagerClientHealthState	configurationManagerClientHealthState	構成マネージャークライアントの正常性状態。MDM/ConfigMgr エージェントによって管理されるデバイスに対してのみ有効
configurationManagerClientInformation	configurationManagerClientInformation	Configuration Manager クライアント情報。ConfigMgr エージェントによって管理、決闘管理、または 3 管理されたデバイスに対してのみ有効
ethernetMacAddress	String	デバイスのイーサネット MAC アドレスを示します。 managedDevice エンティティの一部として返される場合、このプロパティの既定値は Null (既定値以外のプロパティ) です。実際の値を取得するには、選択クエリオプションを使用した個別の get 呼び出しが必要です。例: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select。 $Searchはサポートされていません。読み取り専用です。このプロパティは読み取り専用です。
physicalMemoryInBytes	Int64	合計メモリ (バイト単位)。既定値は 0 です。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。サポート: $select。読み取り専用です。このプロパティは読み取り専用です。
processorArchitecture	managedDeviceArchitecture	プロセッサアーキテクチャ。このプロパティは読み取り専用です。可能な値は、`unknown`、`x86`、`x64`、`arm`、`arM64` です。
specificationVersion	String	仕様バージョン。このプロパティは読み取り専用です。
joinType	joinType	デバイス参加の種類。使用可能な値: `unknown`、`azureADJoined`、`azureADRegistered`、`hybridAzureADJoined`。
skuFamily	String	デバイス SKU ファミリ
securityPatchLevel	String	これは、オペレーティングシステムのセキュリティパッチレベルを示します。これらの特別な更新プログラムには、重要なセキュリティ修正プログラムが含まれています。 iOS/MacOS の場合、それらは (a) 形式です。アンドロイドのために2017-08-07形式で。このプロパティは読み取り専用です。
skuNumber	Int32	デバイス SKU 番号については、「 https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo」も参照してください。有効な値 0 ~ 2147483647。このプロパティは読み取り専用です。
managementFeatures	managedDeviceManagementFeatures	デバイス管理機能。可能な値は、`none`、`microsoftManagedDesktop` です。
chromeOSDeviceInfo	chromeOSDeviceProperty コレクション	ChromeOS デバイスのプロパティの一覧。既定値は空のリストです。実際の値を取得するには、デバイス ID と select パラメーターに含まれる GET 呼び出しを行う必要があります。
enrollmentProfileName	String	デバイスに割り当てられた登録プロファイルの名前。既定値は空の文字列で、登録プロファイルが assgined でないことを示します。このプロパティは読み取り専用です。
bootstrapTokenEscrowed	ブール型	マネージドデバイスにエスクローされたブートストラップトークンがあるかどうかを報告します。これは macOS デバイス専用です。取得するには、select 句に BootstrapTokenEscrowed を含め、デバイス ID を使用してクエリを実行します。FALSE の場合、ブートストラップトークンはエスクローされません。 TRUE の場合、デバイスは Intune でブートストラップトークンをエスクローしました。このプロパティは読み取り専用です。
deviceFirmwareConfigurationInterfaceManaged	ブール型	デバイスが DFCI で管理されているかどうかを示します。 TRUE の場合、デバイスは DFCI で管理されます。 FALSE の場合、デバイスは DFCI 管理されません。既定値は FALSE です。
deviceIdentityAttestationDetail	deviceIdentityAttestationDetail	マネージドデバイスの構成証明の状態を示します。そして、どちらの方法で。既定値: 不明。

応答

成功した場合、このメソッドは 200 OK 応答コードと、更新された managedDevice オブジェクトを応答本文で返します。

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}
Content-type: application/json
Content-length: 9620

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "hardwareInformation": {
    "@odata.type": "microsoft.graph.hardwareInformation",
    "serialNumber": "Serial Number value",
    "totalStorageSpace": 1,
    "freeStorageSpace": 0,
    "imei": "Imei value",
    "meid": "Meid value",
    "manufacturer": "Manufacturer value",
    "model": "Model value",
    "phoneNumber": "Phone Number value",
    "subscriberCarrier": "Subscriber Carrier value",
    "cellularTechnology": "Cellular Technology value",
    "wifiMac": "Wifi Mac value",
    "operatingSystemLanguage": "Operating System Language value",
    "isSupervised": true,
    "isEncrypted": true,
    "batterySerialNumber": "Battery Serial Number value",
    "batteryHealthPercentage": 7,
    "batteryChargeCycles": 3,
    "isSharedDevice": true,
    "sharedDeviceCachedUsers": [
      {
        "@odata.type": "microsoft.graph.sharedAppleDeviceUser",
        "userPrincipalName": "User Principal Name value",
        "dataToSync": true,
        "dataQuota": 9,
        "dataUsed": 8
      }
    ],
    "tpmSpecificationVersion": "Tpm Specification Version value",
    "operatingSystemEdition": "Operating System Edition value",
    "deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
    "deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
    "deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
    "deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
    "osBuildNumber": "Os Build Number value",
    "operatingSystemProductType": 10,
    "ipAddressV4": "Ip Address V4 value",
    "subnetAddress": "Subnet Address value",
    "esimIdentifier": "Esim Identifier value",
    "systemManagementBIOSVersion": "System Management BIOSVersion value",
    "tpmManufacturer": "Tpm Manufacturer value",
    "tpmVersion": "Tpm Version value",
    "wiredIPv4Addresses": [
      "Wired IPv4Addresses value"
    ],
    "batteryLevelPercentage": 7.333333333333333,
    "residentUsersCount": 2,
    "productName": "Product Name value",
    "deviceLicensingStatus": "licenseRefreshPending",
    "deviceLicensingLastErrorCode": 12,
    "deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
  },
  "ownerType": "company",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "managementState": "retirePending",
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "chassisType": "desktop",
  "operatingSystem": "Operating System value",
  "deviceType": "windowsRT",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "aadRegistered": true,
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "lostModeState": "enabled",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true,
    "endpointProtection": true,
    "officeApps": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value",
    "memoryIntegrityProtection": "enabled",
    "memoryAccessProtection": "enabled",
    "virtualizationBasedSecurity": "enabled",
    "firmwareProtection": "systemGuardSecureLaunch",
    "systemManagementMode": "level1",
    "securedCorePC": "enabled"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
  "usersLoggedOn": [
    {
      "@odata.type": "microsoft.graph.loggedOnUser",
      "userId": "User Id value",
      "lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
    }
  ],
  "preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
  "autopilotEnrolled": true,
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "windowsActiveMalwareCount": 9,
  "windowsRemediatedMalwareCount": 13,
  "notes": "Notes value",
  "configurationManagerClientHealthState": {
    "@odata.type": "microsoft.graph.configurationManagerClientHealthState",
    "state": "installed",
    "errorCode": 9,
    "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
  },
  "configurationManagerClientInformation": {
    "@odata.type": "microsoft.graph.configurationManagerClientInformation",
    "clientIdentifier": "Client Identifier value",
    "isBlocked": true,
    "clientVersion": "Client Version value"
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "securityPatchLevel": "Security Patch Level value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop",
  "chromeOSDeviceInfo": [
    {
      "@odata.type": "microsoft.graph.chromeOSDeviceProperty",
      "name": "Name value",
      "value": "Value value",
      "valueType": "Value Type value",
      "updatable": true
    }
  ],
  "enrollmentProfileName": "Enrollment Profile Name value",
  "bootstrapTokenEscrowed": true,
  "deviceFirmwareConfigurationInterfaceManaged": true,
  "deviceIdentityAttestationDetail": {
    "@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
    "deviceIdentityAttestationStatus": "trusted"
  }
}

応答

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

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 9669

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "705c034c-034c-705c-4c03-5c704c035c70",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "hardwareInformation": {
    "@odata.type": "microsoft.graph.hardwareInformation",
    "serialNumber": "Serial Number value",
    "totalStorageSpace": 1,
    "freeStorageSpace": 0,
    "imei": "Imei value",
    "meid": "Meid value",
    "manufacturer": "Manufacturer value",
    "model": "Model value",
    "phoneNumber": "Phone Number value",
    "subscriberCarrier": "Subscriber Carrier value",
    "cellularTechnology": "Cellular Technology value",
    "wifiMac": "Wifi Mac value",
    "operatingSystemLanguage": "Operating System Language value",
    "isSupervised": true,
    "isEncrypted": true,
    "batterySerialNumber": "Battery Serial Number value",
    "batteryHealthPercentage": 7,
    "batteryChargeCycles": 3,
    "isSharedDevice": true,
    "sharedDeviceCachedUsers": [
      {
        "@odata.type": "microsoft.graph.sharedAppleDeviceUser",
        "userPrincipalName": "User Principal Name value",
        "dataToSync": true,
        "dataQuota": 9,
        "dataUsed": 8
      }
    ],
    "tpmSpecificationVersion": "Tpm Specification Version value",
    "operatingSystemEdition": "Operating System Edition value",
    "deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
    "deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
    "deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
    "deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
    "osBuildNumber": "Os Build Number value",
    "operatingSystemProductType": 10,
    "ipAddressV4": "Ip Address V4 value",
    "subnetAddress": "Subnet Address value",
    "esimIdentifier": "Esim Identifier value",
    "systemManagementBIOSVersion": "System Management BIOSVersion value",
    "tpmManufacturer": "Tpm Manufacturer value",
    "tpmVersion": "Tpm Version value",
    "wiredIPv4Addresses": [
      "Wired IPv4Addresses value"
    ],
    "batteryLevelPercentage": 7.333333333333333,
    "residentUsersCount": 2,
    "productName": "Product Name value",
    "deviceLicensingStatus": "licenseRefreshPending",
    "deviceLicensingLastErrorCode": 12,
    "deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
  },
  "ownerType": "company",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "managementState": "retirePending",
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "chassisType": "desktop",
  "operatingSystem": "Operating System value",
  "deviceType": "windowsRT",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "aadRegistered": true,
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "lostModeState": "enabled",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true,
    "endpointProtection": true,
    "officeApps": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value",
    "memoryIntegrityProtection": "enabled",
    "memoryAccessProtection": "enabled",
    "virtualizationBasedSecurity": "enabled",
    "firmwareProtection": "systemGuardSecureLaunch",
    "systemManagementMode": "level1",
    "securedCorePC": "enabled"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
  "usersLoggedOn": [
    {
      "@odata.type": "microsoft.graph.loggedOnUser",
      "userId": "User Id value",
      "lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
    }
  ],
  "preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
  "autopilotEnrolled": true,
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "windowsActiveMalwareCount": 9,
  "windowsRemediatedMalwareCount": 13,
  "notes": "Notes value",
  "configurationManagerClientHealthState": {
    "@odata.type": "microsoft.graph.configurationManagerClientHealthState",
    "state": "installed",
    "errorCode": 9,
    "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
  },
  "configurationManagerClientInformation": {
    "@odata.type": "microsoft.graph.configurationManagerClientInformation",
    "clientIdentifier": "Client Identifier value",
    "isBlocked": true,
    "clientVersion": "Client Version value"
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "securityPatchLevel": "Security Patch Level value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop",
  "chromeOSDeviceInfo": [
    {
      "@odata.type": "microsoft.graph.chromeOSDeviceProperty",
      "name": "Name value",
      "value": "Value value",
      "valueType": "Value Type value",
      "updatable": true
    }
  ],
  "enrollmentProfileName": "Enrollment Profile Name value",
  "bootstrapTokenEscrowed": true,
  "deviceFirmwareConfigurationInterfaceManaged": true,
  "deviceIdentityAttestationDetail": {
    "@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
    "deviceIdentityAttestationStatus": "trusted"
  }
}

次の方法で共有

managedDevice の更新

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック

その他のリソース