WindowsManagedDevice の作成Create windowsManagedDevice

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

重要: ベータ版の Microsoft Graph Api は変更される可能性があります。運用環境での使用はサポートされていません。Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

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

新しい Windowsmanageddevice オブジェクトを作成します。Create a new windowsManagedDevice 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) DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All

HTTP 要求HTTP Request

POST /deviceManagement/managedDevices
POST /deviceManagement/comanagedDevices
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices

要求ヘッダーRequest headers

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

要求本文Request body

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

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

プロパティProperty Type 説明Description
idid StringString デバイスの一意識別子。Unique Identifier for the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
userIduserId StringString デバイスに関連付けられているユーザーの一意の識別子。Unique Identifier for the user associated with the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
deviceNamedeviceName StringString デバイスの名前。Name of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
hardwareInformationhardwareInformation hardwareInformationhardwareInformation デバイスのハードワードの詳細。The hardward details for the device. 記憶領域、製造元、シリアル番号などの情報が含まれます。このプロパティは値の取得のみ可能です。Includes information such as storage space, manufacturer, serial number, etc. This property is read-only. Manageddeviceから継承しますInherited from managedDevice
ownerTypeownerType ownerTypeownerType デバイスの所有権。Ownership of the device. ' Company ' または ' personal ' を Manageddeviceから継承することができます。Can be 'company' or 'personal' Inherited from managedDevice. 可能な値は unknowncompanypersonal です。Possible values are: unknown, company, personal.
managedDeviceOwnerTypemanagedDeviceOwnerType managedDeviceOwnerTypemanagedDeviceOwnerType デバイスの所有権。Ownership of the device. ' Company ' または ' personal ' を Manageddeviceから継承することができます。Can be 'company' or 'personal' Inherited from managedDevice. 可能な値は unknowncompanypersonal です。Possible values are: unknown, company, personal.
deviceActionResultsdeviceActionResults deviceActionResult コレクションdeviceActionResult collection ComplexType deviceActionResult オブジェクトのリスト。List of ComplexType deviceActionResult objects. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
managementStatemanagementState managementStatemanagementState デバイスの管理状態。Management state of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、managedretirePendingretireFailedwipePendingwipeFailedunhealthydeletePendingretireIssuedwipeIssuedwipeCanceledretireCanceleddiscovered です。Possible values are: managed, retirePending, retireFailed, wipePending, wipeFailed, unhealthy, deletePending, retireIssued, wipeIssued, wipeCanceled, retireCanceled, discovered.
enrolledDateTimeenrolledDateTime DateTimeOffsetDateTimeOffset デバイスの登録時刻。Enrollment time of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
lastSyncDateTimelastSyncDateTime DateTimeOffsetDateTimeOffset デバイスが Intune との正常な同期を最終的に完了した日時。The date and time that the device last completed a successful sync with Intune. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
chassisTypechassisType chassisTypechassisType デバイスのシャーシの種類。Chassis type of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、unknowndesktoplaptopworksWorkstationenterpriseServerphonetabletmobileOthermobileUnknown です。Possible values are: unknown, desktop, laptop, worksWorkstation, enterpriseServer, phone, tablet, mobileOther, mobileUnknown.
operatingSystemoperatingSystem StringString デバイスのオペレーティング システム。Operating system of the device. Windows、iOS などこのプロパティは値の取得のみ可能です。Windows, iOS, etc. This property is read-only. Manageddeviceから継承しますInherited from managedDevice
deviceTypedeviceType deviceTypedeviceType デバイスのプラットフォーム。Platform of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値:、、、、、、、、、、、、、、、、、、、 desktop windowsRT winMO6 nokia windowsPhone mac winCE winEmbedded iPhone iPad iPod android iSocConsumer unix macMDM holoLens surfaceHub androidForWork androidEnterprise windows10x androidnGMS cloudPC blackberry palm unknownPossible values are: desktop, windowsRT, winMO6, nokia, windowsPhone, mac, winCE, winEmbedded, iPhone, iPad, iPod, android, iSocConsumer, unix, macMDM, holoLens, surfaceHub, androidForWork, androidEnterprise, windows10x, androidnGMS, cloudPC, blackberry, palm, unknown.
complianceStatecomplianceState complianceStatecomplianceState デバイスのコンプライアンス状態。Compliance state of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、unknowncompliantnoncompliantconflicterrorinGracePeriodconfigManager です。Possible values are: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.
jailBrokenjailBroken StringString デバイスが脱獄またはルート化されているかどうかを示します。whether the device is jail broken or rooted. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
managementAgentmanagementAgent managementAgentTypemanagementAgentType デバイスの管理チャネル。Management channel of the device. Intune、EAS など。このプロパティは値の取得のみ可能です。Intune, EAS, etc. This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、easmdmeasMdmintuneClienteasIntuneClientconfigurationManagerClientconfigurationManagerClientMdmconfigurationManagerClientMdmEasunknownjamfgoogleCloudDevicePolicyControllermicrosoft365ManagedMdmwindowsManagementCloudApi です。Possible values are: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController, microsoft365ManagedMdm, windowsManagementCloudApi.
osVersionosVersion StringString デバイスのオペレーティング システムのバージョン。Operating system version of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
easActivatedeasActivated BooleanBoolean Exchange ActiveSync がアクティブになっているデバイスかどうかを示します。Whether the device is Exchange ActiveSync activated. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
easDeviceIdeasDeviceId StringString デバイスの Exchange ActiveSync の ID。Exchange ActiveSync Id of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
easActivationDateTimeeasActivationDateTime DateTimeOffsetDateTimeOffset デバイスの Exchange ActivationSync のアクティブ化の時刻。Exchange ActivationSync activation time of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
aadRegisteredaadRegistered BooleanBoolean Azure Active Directory が登録されているデバイスかどうかを示します。Whether the device is Azure Active Directory registered. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
azureADRegisteredazureADRegistered BooleanBoolean Azure Active Directory が登録されているデバイスかどうかを示します。Whether the device is Azure Active Directory registered. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
deviceEnrollmentTypedeviceEnrollmentType deviceEnrollmentTypedeviceEnrollmentType デバイスの登録の種類。Enrollment type of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、unknownuserEnrollmentdeviceEnrollmentManagerappleBulkWithUserappleBulkWithoutUserwindowsAzureADJoinwindowsBulkUserlesswindowsAutoEnrollmentwindowsBulkAzureDomainJoinwindowsCoManagementappleUserEnrollmentappleUserEnrollmentWithServiceAccountazureAdJoinUsingAzureVmExtensionandroidEnterpriseDedicatedDeviceandroidEnterpriseFullyManagedandroidEnterpriseCorporateWorkProfile です。Possible values are: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, appleUserEnrollment, appleUserEnrollmentWithServiceAccount, azureAdJoinUsingAzureVmExtension, androidEnterpriseDedicatedDevice, androidEnterpriseFullyManaged, androidEnterpriseCorporateWorkProfile.
lostModeStatelostModeState lostModeStatelostModeState 失われたモードが有効か無効かを示します。Indicates if Lost mode is enabled or disabled. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、disabledenabled です。Possible values are: disabled, enabled.
activationLockBypassCodeactivationLockBypassCode StringString デバイスのアクティベーション ロックをバイパスするためのコード。Code that allows the Activation Lock on a device to be bypassed. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
emailAddressemailAddress StringString デバイスに関連付けられているユーザーの電子メール。Email(s) for the user associated with the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
azureActiveDirectoryDeviceIdazureActiveDirectoryDeviceId StringString Azure Active Directory デバイスの一意識別子。The unique identifier for the Azure Active Directory device. 読み取り専用です。Read only. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
azureADDeviceIdazureADDeviceId StringString Azure Active Directory デバイスの一意識別子。The unique identifier for the Azure Active Directory device. 読み取り専用です。Read only. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
deviceRegistrationStatedeviceRegistrationState deviceRegistrationStatedeviceRegistrationState デバイスの登録状態。Device registration state. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、notRegisteredregisteredrevokedkeyConflictapprovalPendingcertificateResetnotRegisteredPendingEnrollmentunknown です。Possible values are: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown.
deviceCategoryDisplayNamedeviceCategoryDisplayName StringString デバイスカテゴリの表示名。Device category display name. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
isSupervisedisSupervised BooleanBoolean デバイスの監視状態。Device supervised status. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
exchangeLastSuccessfulSyncDateTimeexchangeLastSuccessfulSyncDateTime DateTimeOffsetDateTimeOffset 最後にデバイスが Exchange に接続した時刻。Last time the device contacted Exchange. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
exchangeAccessStateexchangeAccessState deviceManagementExchangeAccessStatedeviceManagementExchangeAccessState Exchange でのデバイスのアクセスの状態。The Access State of the device in Exchange. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、noneunknownallowedblockedquarantined です。Possible values are: none, unknown, allowed, blocked, quarantined.
exchangeAccessStateReasonexchangeAccessStateReason deviceManagementExchangeAccessStateReasondeviceManagementExchangeAccessStateReason Exchange でのデバイスのアクセス状態の理由。
The reason for the device's access state in Exchange. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、noneunknownexchangeGlobalRuleexchangeIndividualRuleexchangeDeviceRuleexchangeUpgradeexchangeMailboxPolicyothercompliantnotCompliantnotEnrolledunknownLocationmfaRequiredazureADBlockDueToAccessPolicycompromisedPassworddeviceNotKnownWithManagedApp です。Possible values are: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp.
remoteAssistanceSessionUrlremoteAssistanceSessionUrl StringString デバイスとのリモート アシスタンス セッションを確立できるようにする URL。Url that allows a Remote Assistance session to be established with the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
remoteAssistanceSessionErrorDetailsremoteAssistanceSessionErrorDetails StringString リモート アシスタンス セッション オブジェクトの作成時に問題を識別するエラー文字列。An error string that identifies issues when creating Remote Assistance session objects. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
isEncryptedisEncrypted BooleanBoolean デバイスの暗号化の状態。Device encryption status. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
userPrincipalNameuserPrincipalName StringString デバイスのユーザープリンシパル名。Device user principal name. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
modelmodel StringString デバイスのモデル。Model of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
manufacturermanufacturer StringString デバイスの製造元。Manufacturer of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
imeiimei StringString IMEI.IMEI. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
complianceGracePeriodExpirationDateTimecomplianceGracePeriodExpirationDateTime DateTimeOffsetDateTimeOffset デバイスコンプライアンスの猶予期間が経過した日時です。The DateTime when device compliance grace period expires. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
シリアル番号serialNumber StringString シリアル.SerialNumber. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
phoneNumberphoneNumber StringString デバイスの電話番号。Phone number of the device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
androidSecurityPatchLevelandroidSecurityPatchLevel StringString Android セキュリティパッチレベル。Android security patch level. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
userDisplayNameuserDisplayName StringString ユーザーの表示名。User display name. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
configurationManagerClientEnabledFeaturesconfigurationManagerClientEnabledFeatures configurationManagerClientEnabledFeaturesconfigurationManagerClientEnabledFeatures Grmgr クライアントが有効になっている機能を設定します。ConfigrMgr client enabled features. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
wiFiMacAddresswiFiMacAddress StringString Wi-fi MAC。Wi-Fi MAC. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
deviceHealthAttestationStatedeviceHealthAttestationState deviceHealthAttestationStatedeviceHealthAttestationState デバイスの正常性構成証明の状態。The device health attestation state. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
subscriberCarriersubscriberCarrier StringString サブスクライバーキャリア。Subscriber Carrier. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
meidmeid StringString MEID.MEID. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
totalStorageSpaceInBytestotalStorageSpaceInBytes Int64Int64 合計記憶域 (バイト単位)。Total Storage in Bytes. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
freeStorageSpaceInBytesfreeStorageSpaceInBytes Int64Int64 空き容量 (バイト単位)。Free Storage in Bytes. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
managedDeviceNamemanagedDeviceName StringString デバイスを識別する名前が自動的に生成されます。Automatically generated name to identify a device. ユーザー フレンドリ名に上書きできます。Can be overwritten to a user friendly name. Manageddeviceから継承しますInherited from managedDevice
partnerReportedThreatStatepartnerReportedThreatState managedDevicePartnerReportedHealthStatemanagedDevicePartnerReportedHealthState Mobile Threat Defense パートナーがアカウントおよびデバイスで使用されている場合の、デバイスの脅威の状態を示します。Indicates the threat state of a device when a Mobile Threat Defense partner is in use by the account and device. 読み取り専用です。Read Only. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、unknownactivateddeactivatedsecuredlowSeveritymediumSeverityhighSeverityunresponsivecompromisedmisconfigured です。Possible values are: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured.
retireAfterDateTimeretireAfterDateTime DateTimeOffsetDateTimeOffset スケジュールされたアクションのためにデバイスが自動廃棄されるまでの時間を示します。Indicates the time after when a device will be auto retired because of scheduled action. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
usersLoggedOnusersLoggedOn loggedOnUser コレクションloggedOnUser collection デバイスの最後にログオンしたユーザーを示します。Indicates the last logged on users of a device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
preferMdmOverGroupPolicyAppliedDateTimepreferMdmOverGroupPolicyAppliedDateTime DateTimeOffsetDateTimeOffset PreferMdmOverGroupPolicy の設定が設定された DateTime を報告します。Reports the DateTime the preferMdmOverGroupPolicy setting was set. 設定すると、競合がある場合に Intune MDM 設定がグループポリシー設定を上書きします。When set, the Intune MDM settings will override Group Policy settings if there is a conflict. 読み取り専用です。Read Only. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
autopilotEnrolledautopilotEnrolled ブール値Boolean 管理対象デバイスが自動パイロットで登録されているかどうかを報告します。Reports if the managed device is enrolled via auto-pilot. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
requireUserEnrollmentApprovalrequireUserEnrollmentApproval ブール値Boolean 管理対象 iOS デバイスがユーザー承認登録であるかどうかを報告します。Reports if the managed iOS device is user approval enrollment. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
managementCertificateExpirationDatemanagementCertificateExpirationDate DateTimeOffsetDateTimeOffset デバイス管理証明書の有効期限を報告します。Reports device management certificate expiration date. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
iccidiccid StringString Ic カード識別子。 SIM カードの一意の識別番号です。Integrated Circuit Card Identifier, it is A SIM card's unique identification number. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
udidudid StringString IOS および macOS デバイスの一意のデバイス識別子。Unique Device Identifier for iOS and macOS devices. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
roleScopeTagIdsroleScopeTagIds String コレクションString collection このデバイスインスタンスの範囲タグ Id のリスト。List of Scope Tag IDs for this Device instance. Manageddeviceから継承しますInherited from managedDevice
windowsActiveMalwareCount 再計算windowsActiveMalwareCount Int32Int32 この windows デバイスのアクティブなマルウェアの数。Count of active malware for this windows device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
windowsRemediatedMalwareCountwindowsRemediatedMalwareCount Int32Int32 この windows デバイスの修復済みマルウェアの数。Count of remediated malware for this windows device. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
notesnotes StringString IT 管理者によって作成された、 manageddeviceから継承したデバイス上のメモNotes on the device created by IT Admin Inherited from managedDevice
configurationManagerClientHealthStateconfigurationManagerClientHealthState configurationManagerClientHealthStateconfigurationManagerClientHealthState 構成マネージャークライアントの正常性状態。 MDM/ConfigMgr エージェントによって管理されているデバイスに対してのみ有効。 Manageddeviceから継承されます。Configuration manager client health state, valid only for devices managed by MDM/ConfigMgr Agent Inherited from managedDevice
configurationManagerClientInformationconfigurationManagerClientInformation configurationManagerClientInformationconfigurationManagerClientInformation Configuration manager クライアント情報。管理されたデバイス、または管理されたデバイス、またはManageddeviceから継承された、ConfigMgr エージェントによって管理されたデバイスに対してのみ有効です。Configuration manager client information, valid only for devices managed, duel-managed or tri-managed by ConfigMgr Agent Inherited from managedDevice
イーサネットの MacaddressethernetMacAddress StringString イーサネット MAC。Ethernet MAC. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
physicalMemoryInBytesphysicalMemoryInBytes Int64Int64 合計メモリ (バイト)。Total Memory in Bytes. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
processorArchitectureprocessorArchitecture managedDeviceArchitecturemanagedDeviceArchitecture プロセッサアーキテクチャ。Processor architecture. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承されます。Inherited from managedDevice. 可能な値は、unknownx86x64armarM64 です。Possible values are: unknown, x86, x64, arm, arM64.
仕様バージョンspecificationVersion StringString 仕様バージョン。Specification version. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
joinTypejoinType joinTypejoinType Manageddeviceから継承されたデバイスの参加の種類。Device join type Inherited from managedDevice. 使用可能な値は、unknownazureADJoinedazureADRegisteredhybridAzureADJoined です。Possible values are: unknown, azureADJoined, azureADRegistered, hybridAzureADJoined.
skuFamilyskuFamily StringString Manageddeviceから継承されたデバイス sku ファミリDevice sku family Inherited from managedDevice
skuNumberskuNumber Int32Int32 デバイスの sku 番号。「」も参照してください https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfoDevice sku number, see also: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. 有効な値は0から2147483647です。Valid values 0 to 2147483647. このプロパティに値を設定するには、 SetExtrusionDirection メソッドを適用します。This property is read-only. Manageddeviceから継承しますInherited from managedDevice
managementFeaturesmanagementFeatures managedDeviceManagementFeaturesmanagedDeviceManagementFeatures Manageddeviceから継承されたデバイス管理機能。Device management features Inherited from managedDevice. 可能な値は、nonemicrosoftManagedDesktop です。Possible values are: none, microsoftManagedDesktop.

応答Response

成功した場合、このメソッドは応答 201 Created コードと、応答本文で Windowsmanageddevice オブジェクトを返します。If successful, this method returns a 201 Created response code and a windowsManagedDevice object in the response body.

Example

要求Request

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

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

{
  "@odata.type": "#microsoft.graph.windowsManagedDevice",
  "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
  },
  "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"
  },
  "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
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop"
}

応答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 201 Created
Content-Type: application/json
Content-Length: 8075

{
  "@odata.type": "#microsoft.graph.windowsManagedDevice",
  "id": "97842b67-2b67-9784-672b-8497672b8497",
  "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
  },
  "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"
  },
  "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
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family value",
  "skuNumber": 9,
  "managementFeatures": "microsoftManagedDesktop"
}