user リソースの種類user resource type

Azure AD ユーザー アカウントを表します。directoryObject から継承します。Represents an Azure AD user account. Inherits from directoryObject.

このリソースは以下をサポートしています。This resource supports:

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
user のリストList users user コレクションuser collection ユーザー オブジェクトのリストを取得します。Get a list of user objects.
ユーザーを作成するCreate user useruser 新しいユーザー オブジェクトを作成します。Create a new user object.
Get userGet user useruser ユーザー オブジェクトのプロパティと関係を読み取ります。Read properties and relationships of user object.
Update userUpdate user useruser ユーザー オブジェクトを更新します。Update user object.
Delete userDelete user NoneNone ユーザー オブジェクトを削除します。Delete user object.
List messagesList messages Message collectionMessage collection サインインしているユーザーのメールボックス内のすべてのメッセージを取得します。Get all the messages in the signed-in user's mailbox.
Create MessageCreate Message MessageMessage メッセージ コレクションへの投稿により、新しいメッセージを作成します。Create a new Message by posting to the messages collection.
List mailFoldersList mailFolders MailFolder collectionMailFolder collection サインイン中のユーザーのルート フォルダーからメール フォルダー コレクションを取得します。Get the mail folder collection under the root folder of the signed-in user.
Create mailFolderCreate mailFolder MailFolderMailFolder mailFolder コレクションへの投稿により、新しい MailFolder を作成します。Create a new MailFolder by posting to the mailFolders collection.
sendMailsendMail NoneNone 要求本文に指定されたメッセージを送信します。Send the message specified in the request body.
List eventsList events Event collectionEvent collection ユーザーのメールボックス内のイベント オブジェクトの一覧を取得します。一覧には、単一インスタンスの会議と定期的なマスターが含まれています。Get a list of event objects in the user's mailbox. The list contains single instance meetings and series masters.
Create eventCreate event EventEvent Event コレクションへの投稿によって、新しいイベントを作成します。Create a new Event by posting to the events collection.
List calendarsList calendars Calendar collectionCalendar collection 予定表オブジェクトのコレクションを取得します。Get a Calendar object collection.
Create calendarCreate calendar CalendarCalendar 予定表コレクションへの投稿により、新しい予定表を作成します。Create a new Calendar by posting to the calendars collection.
List calendarGroupsList calendarGroups CalendarGroup collectionCalendarGroup collection CalendarGroup オブジェクトのコレクションを取得します。Get a CalendarGroup object collection.
Create calendarGroupCreate calendarGroup CalendarGroupCalendarGroup calendarGroups コレクションへの投稿により、新しい CalendarGroup を作成します。Create a new CalendarGroup by posting to the calendarGroups collection.
List calendarViewList calendarView Event collectionEvent collection Event オブジェクトのコレクションを取得します。Get a Event object collection.
List contactsList contacts Contact collectionContact collection サインイン中のユーザーの既定の連絡先フォルダーから連絡先コレクションを取得します。Get a contact collection from the default Contacts folder of the signed-in user.
Create ContactCreate Contact ContactContact 連絡先コレクションに投稿することにより、新しい連絡先を作成します。Create a new Contact by posting to the contacts collection.
List contactFoldersList contactFolders ContactFolder collectionContactFolder collection サインイン中のユーザーの既定の連絡先フォルダー内の連絡先フォルダーのコレクションを取得します。Get the contact folder collection in the default Contacts folder of the signed-in user.
Create ContactFolderCreate ContactFolder ContactFolderContactFolder contactFolder コレクションに投稿することにより、新しい ContactFolder を作成します。Create a new ContactFolder by posting to the contactFolders collection.
List directReportsList directReports directoryObject collectiondirectoryObject collection そのユーザーの部下であるユーザーと連絡先を、directReports ナビゲーション プロパティから取得します。Get the users and contacts that report to the user from the directReports navigation property.
List managerList manager directoryObjectdirectoryObject そのユーザーの上司であるユーザーまたは連絡先を、マネージャー ナビゲーション プロパティから取得します。Get the user or contact that is this user's manager from the manager navigation property.
List memberOfList memberOf directoryObject collectiondirectoryObject collection そのユーザーが直接のメンバーであるグループおよびディレクトリ ロールを、memberOf ナビゲーション プロパティから取得します。Get the groups and directory roles that the user is a direct member of from the memberOf navigation property.
推移的な memberOf を一覧表示するList transitive memberOf directoryObject コレクションdirectoryObject collection ユーザーがメンバーになっているグループとディレクトリ ロールを一覧表示します。List the groups and directory roles that the user is a member of. この操作は推移的で、このユーザーが入れ子のメンバーになっているグループが含まれます。This operation is transitive and includes the groups that the user is a nested member of.
LownedDevices を一覧表示するList ownedDevices directoryObject collectiondirectoryObject collection そのユーザーにより所有されているデバイスを、OwnedDevices ナビゲーション プロパティから取得します。Get the devices that are owned by the user from the ownedDevices navigation property.
List ownedObjectsList ownedObjects directoryObject collectiondirectoryObject collection そのユーザーにより所有されているディレクトリ オブジェクトを、ownedObjects ナビゲーション プロパティから取得します。Get the directory objects that are owned by the user from the ownedObjects navigation property.
List registeredDevicesList registeredDevices directoryObject collectiondirectoryObject collection そのユーザーについて登録されているデバイスを、RegisteredDevices ナビゲーション プロパティから取得します。Get the devices that are retistered for the user from the registeredDevices navigation property.
List createdObjectsList createdObjects directoryObject collectiondirectoryObject collection そのユーザーにより作成されたディレクトリ オブジェクトを、createdObjects ナビゲーション プロパティから取得します。Get the directory objects created by the user from the createdObjects navigation property.
assignLicenseassignLicense useruser ユーザーのサブスクリプションを追加または削除します。また、サブスクリプションに関連付けられている特定のプランを有効または無効にすることもできます。Add or remove subscriptions for the user. You can also enable and disable specific plans associated with a subscription.
licenseDetails を一覧表示するList licenseDetails licenseDetails コレクションlicenseDetails collection licenseDetails オブジェクトのコレクションを取得します。Get a licenseDetails object collection.
checkMemberGroupscheckMemberGroups String collectionString collection グループの一覧内のメンバーシップを確認します。チェックは推移的です。Check for membership in a list of groups. The check is transitive.
getMemberGroupsgetMemberGroups String collectionString collection ユーザーがメンバーであるすべてのグループを返します。チェックは推移的です。Return all the groups that the user is a member of. The check is transitive.
getMemberObjectsgetMemberObjects String collectionString collection ユーザーがメンバーになっているすべてのグループとディレクトリ ロールを返します。チェックは推移的です。Return all of the groups and directory roles that the user is a member of. The check is transitive.
reminderViewreminderView Reminder collectionReminder collection 指定した開始時刻と終了時刻内の予定表のアラームの一覧を返します。Return a list of calendar reminders within the start and end times specified.
deltadelta user コレクションuser collection ユーザーに対する増分の変更を取得します。Get incremental changes for users.
オープン拡張機能Open extensions
オープン拡張機能を作成するCreate open extension openTypeExtensionopenTypeExtension オープン拡張機能を作成し、新規または既存のリソースにカスタム プロパティを追加します。Create an open extension and add custom properties to a new or existing resource.
オープン拡張機能を取得するGet open extension openTypeExtension コレクションopenTypeExtension collection 拡張機能の名前で識別されるオープン拡張機能を取得します。Get an open extension identified by the extension name.
スキーマ拡張機能Schema extensions
スキーマ拡張機能の値を追加するAdd schema extension values スキーマ拡張機能の定義を作成し、それを使用してカスタマイズされた種類のデータをリソースに追加します。Create a schema extension definition and then use it to add custom typed data to a resource.

プロパティProperties

プロパティProperty Type 説明Description
aboutMeaboutMe StringString ユーザーが自分自身について記述する、フリー フォームのテキスト入力フィールド。A freeform text entry field for the user to describe themselves.
accountEnabledaccountEnabled BooleanBoolean アカウントが有効な場合は true。そうでない場合は false。このプロパティは、ユーザーの作成時に必要です。$filter をサポートします。true if the account is enabled; otherwise, false. This property is required when a user is created. Supports $filter.
ageGroupageGroup StringString ユーザーの年齢グループを設定します。Sets the age group of the user. 使用できる値: nullminornotAdult、および adultAllowed values: null, minor, notAdult and adult. 詳細については、「法的年齢グループ プロパティの定義」を参照してください。Refer to the legal age group property definitions for further information.
assignedLicensesassignedLicenses assignedLicense collectionassignedLicense collection ユーザーに割り当てられているライセンス。null 許容ではありません。The licenses that are assigned to the user. Not nullable.
assignedPlansassignedPlans assignedPlan collectionassignedPlan collection ユーザーに割り当てられているプラン。読み取り専用です。null 許容ではありません。The plans that are assigned to the user. Read-only. Not nullable.
birthdaybirthday DateTimeOffsetDateTimeOffset ユーザーの誕生日。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
businessPhonesbusinessPhones String collectionString collection ユーザーの電話番号。注:文字列コレクションですが、このプロパティに設定できるのは 1 つの数字のみです。The telephone numbers for the user. NOTE: Although this is a string collection, only one number can be set for this property.
citycity StringString ユーザーがいる都市。$filter をサポートします。The city in which the user is located. Supports $filter.
companyNamecompanyName StringString ユーザーが関連付けられている会社名。The company name which the user is associated. このプロパティは、外部ユーザーが所属する会社を記述するのに役立ちます。This property can be useful for describing the company that an external user comes from.
consentProvidedForMinorconsentProvidedForMinor StringString 未成年者について同意を得ているかどうかを設定します。Sets whether consent has been obtained for minors. 使用できる値: nullgranteddenied、および notRequiredAllowed values: null, granted, denied and notRequired. 詳細については、「法的年齢グループ プロパティの定義」を参照してください。Refer to the legal age group property definitions for further information.
countrycountry StringString ユーザーがいる国/地域。たとえば、「US (米国)」や「UK (英国)」です。$filter をサポートします。The country/region in which the user is located; for example, “US” or “UK”. Supports $filter.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset ユーザー オブジェクトの作成日です。The created date of the user object.
departmentdepartment StringString ユーザーが働いている部門の名前。$filter をサポートします。The name for the department in which the user works. Supports $filter.
displayNamedisplayName StringString アドレス帳に表示されるユーザーの名前。これは通常、ユーザーの名前、ミドルネームのイニシャル、姓の組み合わせです。このプロパティは、ユーザーの作成時に必須になります。更新時にクリアすることはできません。$filter および $orderby をサポートします。The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates. Supports $filter and $orderby.
employeeIdemployeeId StringString 組織によりユーザーに割り当てられた従業員 ID。The employee identifier assigned to the user by the organization. $filter をサポートします。Supports $filter.
faxNumberfaxNumber StringString ユーザーの Fax 番号。The fax number of the user.
givenNamegivenName StringString ユーザーの名。$filter をサポートします。The given name (first name) of the user. Supports $filter.
hireDatehireDate DateTimeOffsetDateTimeOffset ユーザーの採用日付。Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
idid StringString ユーザーの一意の識別子。directoryObject から継承されます。キー。null 許容ではありません。読み取り専用です。The unique identifier for the user. Inherited from directoryObject. Key. Not nullable. Read-only.
imAddressesimAddresses String collectionString collection ユーザーのインスタント メッセージ ボイス オーバー IP (VOIP) セッション開始プロトコル (SIP) のアドレス。読み取り専用です。The instant message voice over IP (VOIP) session initiation protocol (SIP) addresses for the user. Read-only.
interestsinterests String collectionString collection ユーザーが自分の関心事を記述する一覧。A list for the user to describe their interests.
jobTitlejobTitle StringString ユーザーの役職。$filter をサポートします。The user’s job title. Supports $filter.
legalAgeGroupClassificationlegalAgeGroupClassification StringString エンタープライズ アプリケーションで使用され、ユーザーの法的年齢グループを示します。Used by enterprise applications to determine the legal age group of the user. このプロパティは読み取り専用であり、ageGroup プロパティと consentProvidedForMinor プロパティに基づいて計算されます。This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. 使用できる値: nullminorWithOutParentalConsentminorWithParentalConsentminorNoParentalConsentRequirednotAdult、および adultAllowed values: null, minorWithOutParentalConsent, minorWithParentalConsent, minorNoParentalConsentRequired, notAdult and adult. 詳細については、「法的年齢グループ プロパティの定義」を参照してください。Refer to the legal age group property definitions for further information.)
licenseAssignmentStateslicenseAssignmentStates licenseAssignmentState コレクションlicenseAssignmentState collection このユーザーへのライセンス割り当ての状態です。State of license assignments for this user. 読み取り専用です。Read-only.
mailmail StringString ユーザーの SMTP アドレス (たとえば、"jeff@contoso.onmicrosoft.com")。読み取り専用。$filter をサポートします。The SMTP address for the user, for example, "jeff@contoso.onmicrosoft.com". Read-Only. Supports $filter.
mailboxSettingsmailboxSettings mailboxSettingsmailboxSettings サインイン ユーザーのプライマリ メールボックスの設定。着信メッセージに対する自動応答を送信するための設定、ロケール、タイム ゾーンを 取得 または 更新 できます。Settings for the primary mailbox of the signed-in user. You can get or update settings for sending automatic replies to incoming messages, locale and time zone.
mailNicknamemailNickname StringString ユーザーの電子メール エイリアス。ユーザーの作成時に、このプロパティを指定する必要があります。$filter をサポートします。The mail alias for the user. This property must be specified when a user is created. Supports $filter.
mobilePhonemobilePhone StringString ユーザーの主な携帯電話の番号。The primary cellular telephone number for the user.
mySitemySite StringString ユーザーの個人用サイトの URL。The URL for the user's personal site.
officeLocationofficeLocation StringString ユーザーの勤務先の場所。The office location in the user's place of business.
onPremisesDistinguishedNameonPremisesDistinguishedName StringString オンプレミスの Active Directory distinguished name または DN が含まれています。Contains the on-premises Active Directory distinguished name or DN. このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
onPremisesDomainNameonPremisesDomainName StringString オンプレミス ディレクトリから同期されたオンプレミス domainFQDN (dnsDomainName とも呼ばれます) が含まれています。Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory. このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
onPremisesExtensionAttributesonPremisesExtensionAttributes OnPremisesExtensionAttributesOnPremisesExtensionAttributes ユーザーの extensionAttribute 1 ~ 15 が含まれています。Contains extensionAttributes 1-15 for the user. 個々の拡張属性は選択もフィルター処理もできないことに注意してください。Note that the individual extension attributes are neither selectable nor filterable. onPremisesSyncEnabled ユーザーの場合、この一連のプロパティはマスターされており、読み取り専用です。For an onPremisesSyncEnabled user, this set of properties is mastered on-premises and is read-only. クラウド専用ユーザー (onPremisesSyncEnabled が false) の場合、これらのプロパティは作成時または更新時に設定される可能性があります。For a cloud-only user (where onPremisesSyncEnabled is false), these properties may be set during creation or update.
onPremisesImmutableIdonPremisesImmutableId StringString このプロパティは、オンプレミスの Active Directory ユーザー アカウントを Azure AD ユーザー オブジェクトに関連付けるために使用します。This property is used to associate an on-premises Active Directory user account to their Azure AD user object. Graph で新しいユーザー アカウントを作成するとき、ユーザーの userPrincipalName (UPN) プロパティにフェデレーション ドメインを使用する場合は、このプロパティを指定する必要があります。This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user’s userPrincipalName (UPN) property. 重要: $_ の文字は、このプロパティを指定するときには使用できません。Important: The $ and _ characters cannot be used when specifying this property. $filter をサポートします。Supports $filter.
onPremisesLastSyncDateTimeonPremisesLastSyncDateTime DateTimeOffsetDateTimeOffset オブジェクトがオンプレミス ディレクトリと前回、同期された日時を示します。例:"2013-02-16T03:04:54Z"Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、必ず UTC 時間です。たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、次のようになります。'2014-01-01T00:00:00Z'読み取り専用です。Indicates the last time at which the object was synced with the on-premises directory; for example: "2013-02-16T03:04:54Z". The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only.
onPremisesProvisioningErrorsonPremisesProvisioningErrors onPremisesProvisioningError コレクションonPremisesProvisioningError collection Microsoft 同期製品のプロビジョニング中に発生するエラーです。Errors when using Microsoft synchronization product during provisioning.
onPremisesSamAccountNameonPremisesSamAccountName StringString オンプレミス ディレクトリから同期されたオンプレミス samAccountName が含まれています。Contains the on-premises samAccountName synchronized from the on-premises directory. このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
onPremisesSecurityIdentifieronPremisesSecurityIdentifier StringString オンプレミスからクラウドに同期されたユーザーのオンプレミスのセキュリティ識別子 (SID) が含まれます。読み取り専用です。Contains the on-premises security identifier (SID) for the user that was synchronized from on-premises to the cloud. Read-only.
onPremisesSyncEnabledonPremisesSyncEnabled BooleanBoolean このオブジェクトがオンプレミスのディレクトリから同期される場合は true、このオブジェクトが最初にオンプレミスのディレクトリから同期されていて、今後は同期しない場合は false、このオブジェクトがオンプレミスのディレクトリから 1 度も同期されたことがない場合は null (既定値)。読み取り専用true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Read-only
onPremisesUserPrincipalNameonPremisesUserPrincipalName StringString オンプレミス ディレクトリから同期されたオンプレミス userPrincipalName が含まれています。Contains the on-premises userPrincipalName synchronized from the on-premises directory. このプロパティは、オンプレミス ディレクトリを Azure AD Connect 経由で Azure Active Directory と同期する顧客の場合にのみ読み込まれます。The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory via Azure AD Connect. 読み取り専用です。Read-only.
otherMailsotherMails StringString ユーザーの追加のメール アドレスの一覧 (例: ["bob@contoso.com", "Robert@fabrikam.com"])。A list of additional email addresses for the user; for example: ["bob@contoso.com", "Robert@fabrikam.com"]. $filter をサポートします。Supports $filter.
passwordPoliciespasswordPolicies StringString ユーザーのパスワード ポリシーを指定します。この値は列挙値であり、可能な 1 つの値は "DisableStrongPassword" です。この場合は、既定のポリシーより脆弱なパスワードを指定できます。"DisablePasswordExpiration" を指定することもできます。2 つを一緒に指定することもできます。例:"DisablePasswordExpiration, DisableStrongPassword"Specifies password policies for the user. This value is an enumeration with one possible value being “DisableStrongPassword”, which allows weaker passwords than the default policy to be specified. “DisablePasswordExpiration” can also be specified. The two may be specified together; for example: "DisablePasswordExpiration, DisableStrongPassword".
passwordProfilepasswordProfile PasswordProfilePasswordProfile ユーザーのパスワード プロファイルを指定します。プロファイルには、ユーザーのパスワードが含まれています。このプロパティは、ユーザーの作成時に必要です。プロファイルにあるパスワードは、passwordPolicies プロパティによって指定されている最小要件を満たす必要があります。既定では、強力なパスワードが必要です。Specifies the password profile for the user. The profile contains the user’s password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required.
pastProjectspastProjects String collectionString collection ユーザーが過去のプロジェクトを列挙する一覧。A list for the user to enumerate their past projects.
postalCodepostalCode StringString ユーザーの住所の郵便番号。郵便番号は、ユーザーの国/地域に固有です。アメリカ合衆国では、この属性には、ZIP コードが含まれます。The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code.
preferredDataLocationpreferredDataLocation StringString ユーザーの優先されるデータの場所。The preferred data location for the user. 詳細については、「OneDrive Online Multi-Geo」を参照してください。For more information, see OneDrive Online Multi-Geo.
preferredLanguagepreferredLanguage StringString ユーザーが設定する言語。ISO 639-1 コードに従う必要があります。たとえば "en-US" です。The preferred language for the user. Should follow ISO 639-1 Code; for example "en-US".
preferredNamepreferredName StringString ユーザーが設定する名前。The preferred name for the user.
provisionedPlansprovisionedPlans ProvisionedPlan collectionProvisionedPlan collection ユーザーのために用意されたプラン。読み取り専用です。null 許容ではありません。The plans that are provisioned for the user. Read-only. Not nullable.
proxyAddressesproxyAddresses String collectionString collection 例:["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] 複数値プロパティのフィルター式には、任意の演算子が必要です。読み取り専用。null 許容ではありません。$filter をサポートします。For example: ["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"] The any operator is required for filter expressions on multi-valued properties. Read-only, Not nullable. Supports $filter.
responsibilitiesresponsibilities String collectionString collection ユーザーが自分の責任の範囲を列挙する一覧。A list for the user to enumerate their responsibilities.
schoolsschools String collectionString collection ユーザーが在籍した学校を列挙する一覧。A list for the user to enumerate the schools they have attended.
showInAddressListshowInAddressList BooleanBoolean Outlook グローバル アドレス一覧にこのユーザーが含まれている必要がある場合は true、それ以外の場合は falsetrue if the Outlook global address list should contain this user, otherwise false. 設定されていない場合は、true として扱われます。If not set, this will be treated as true. 招待マネージャーから招待されたユーザーの場合、このプロパティは false に設定されます。For users invited through the invitation manager, this property will be set to false.
skillsskills String collectionString collection ユーザーが自分のスキルを列挙する一覧。A list for the user to enumerate their skills.
statestate StringString ユーザーの住所の都道府県。$filter をサポートします。The state or province in the user's address. Supports $filter.
streetAddressstreetAddress StringString ユーザーの勤務先の番地。The street address of the user's place of business.
surnamesurname StringString ユーザーの姓。$filter をサポートします。The user's surname (family name or last name). Supports $filter.
usageLocationusageLocation StringString 2 文字の国コード (ISO 規格 3166)国におけるサービスの利用可能性を確認することが法的に義務付けられているため、ライセンスを割り当てられるユーザーには必須です。例:"US"、"JP"、"GB"null 許容ではありません。$filter をサポートします。A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: "US", "JP", and "GB". Not nullable. Supports $filter.
userPrincipalNameuserPrincipalName StringString ユーザーのユーザー プリンシパル名 (UPN)。UPN は、インターネット標準 RFC 822 に基づいた、インターネット スタイルのユーザーのログイン名です。規則では、これはユーザーの電子メール名にマップされる必要があります。一般的な形式は alias@domain です。このドメインは、検証済みドメインのテナントのコレクション内に存在している必要があります。このプロパティは、ユーザーの作成時に必要です。テナントの検証済みのドメインには、organizationverifiedDomains プロパティからアクセスできます。$filter および $orderby をサポートします。The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant’s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Supports $filter and $orderby.
userTypeuserType StringString ディレクトリ内のユーザーの種類を分類するために使用する文字列値 (“Member”、“Guest” など)。$filter をサポートします。A string value that can be used to classify user types in your directory, such as “Member” and “Guest”. Supports $filter.

ここでは、Azure AD 管理者とエンタープライズ アプリケーション開発者が 3 つの年齢グループ プロパティ (legalAgeGroupClassificationageGroup、および consentProvidedForMinor) を使用して年齢関連の規制に準拠する方法を説明します。This section explains how the three age group properties (legalAgeGroupClassification, ageGroup and consentProvidedForMinor) are used by Azure AD administrators and enterprise application developers to meet age-related regulations.

例: Cameron は英国の Holyport にある小学校でディレクトリを管理する管理者です。For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. 学年の始まりに、英国の年齢関連の規制に基づき、入学書類を使用して未成年者の保護者から同意を得ます。At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. 保護者から取得した同意により、未成年者のアカウントを Holyport スクールと Microsoft アプリが使用することが許可されます。The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. 次に Cameron はすべてのアカウントを作成し、ageGroup を "minor" に、consentProvidedForMinor を "granted" に設定します。Cameron then creates all the accounts and sets ageGroup to "minor" and consentProvidedForMinor to "granted". これにより、生徒が使用するアプリケーションでは未成年に適していない機能が非表示になります。Applications used by his students are then able to suppress features that are not suitable for minors.

この読み取り専用プロパティは、エンタープライズ アプリケーション開発者が、ユーザーの法的年齢グループに基づいてそのユーザーを適切に処理できるようにするために使用します。This read-only property is used by enterprise application developers to ensure the correct handling of a user based on their legal age group. ユーザーの ageGroup および consentProvidedForMinor プロパティに基づいて計算されます。It is calculated based on the user's ageGroup and consentProvidedForMinor properties.

Value # 説明Description
nullnull 00% 既定値。ユーザーに ageGroup が設定されていません。Default value, no ageGroup has been set for the user.
minorWithoutParentalConsentminorWithoutParentalConsent 1$1 (将来使用するために予約されています)(Reserved for future use)
minorWithParentalConsentminorWithParentalConsent 2-2 当該国または地域の年齢関連規制に基づいてユーザーが未成年と判断され、アカウントの管理者が保護者から適切な同意を得ています。The user is considered a minor based on the age-related regulations of their country or region and the administrator of the account has obtained appropriate consent from a parent or guardian.
adultadult 3-3 当該国または地域の年齢関連規制に基づいて成人と判断されたユーザー。The user considered an adult based on the age-related regulations of their country or region.
notAdultnotAdult 4-4 追加の年齢関連規制がある国または地域 (米国、英国、欧州連合、韓国など) にいるユーザーであり、ユーザーの年齢が未成年と成人の間です (国または地域での規定に基づく)。The user is from a country or region that has additional age-related regulations (such as the United States, United Kingdom, European Union or South Korea), and the user's age is between a minor and an adult age (as stipulated based on country or region). 通常、規制対象の国では 10 代の若者は notAdult とみなされます。Generally, this means that teenagers are considered as notAdult in regulated countries.
minorNoParentalConsentRequiredminorNoParentalConsentRequired 5$-5 ユーザーは未成年ですが、年齢関連の規制のない国または地域にいます。The user is a minor but is from a country or region that has no age-related regulations.

年齢グループと未成年の同意のプロパティはオプションであり、Azure AD 管理者はこれらのプロパティを使用して、ユーザーの国または地域で施行されている年齢関連の規制に基づいてアカウントの使用が正しく処理されるようにします。The age group and minor consent properties are optional properties used by Azure AD administrators to help ensure the use of an account is handled correctly based on the age-related regulatory rules governing the user's country or region.

ageGroup プロパティageGroup property

Value # 説明Description
nullnull 00% 既定値。ユーザーに ageGroup が設定されていません。Default value, no ageGroup has been set for the user.
minorminor 1$1 ユーザーは未成年として扱われます。The user is consider a minor.
notAdultnotAdult 2-2 ユーザーは法的規制のある国 (米国、英国、欧州連合、または韓国) におり、ユーザーの年齢は未成年者の年齢の上限 (国に応じて異なる) を超えているが成人の年齢の下限 (国または地域に基づき規定されている) 未満です。The user is from a country that has statutory regulations United States, United Kingdom, European Union or South Korea) and user’s age is more than the upper limit of kid age (as per country) and less than lower limit of adult age (as stipulated based on country or region). したがって基本的に 10 代の若者は規制対象の国では notAdult とみなされます。So basically, teenagers are considered as notAdult in regulated countries.
adultadult 3-3 ユーザーは成人として扱われます。The user should be a treated as an adult.

consentProvidedForMinor プロパティconsentProvidedForMinor property

Value # 説明Description
nullnull 00% 既定値。ユーザーに consentProvidedForMinor が設定されていません。Default value, no consentProvidedForMinor has been set for the user.
grantedgranted 1$1 ユーザーがアカウントを所有することについて同意が得られています。Consent has been obtained for the user to have an account.
denieddenied 2-2 ユーザーがアカウントを所有することについて同意が得られていません。Consent has not been obtained for the user to have an account.
notRequirednotRequired 3-3 ユーザーは、同意を必要としない場所にいます。The user is from a location that does not require consent.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
アクティビティactivities userActivity コレクションuserActivity collection デバイス間におけるユーザーのアクティビティ。The user's activities across devices. 読み取り専用です。Read-only. Null 許容型。Nullable.
calendarcalendar CalendarCalendar ユーザーの標準予定表。読み取り専用です。The user's primary calendar. Read-only.
calendarGroupscalendarGroups CalendarGroup collectionCalendarGroup collection ユーザーの予定表グループ。読み取り専用です。Null 許容型。The user's calendar groups. Read-only. Nullable.
calendarViewcalendarView Event collectionEvent collection 予定表のカレンダー ビュー。読み取り専用です。Null 許容型。The calendar view for the calendar. Read-only. Nullable.
calendarscalendars Calendar collectionCalendar collection ユーザーの予定表。読み取り専用です。Null 許容型。The user's calendars. Read-only. Nullable.
contactFolderscontactFolders ContactFolder collectionContactFolder collection ユーザーの連絡先フォルダー。読み取り専用です。Null 許容型。The user's contacts folders. Read-only. Nullable.
contactscontacts Contact collectionContact collection ユーザーの連絡先。読み取り専用です。Null 許容型。The user's contacts. Read-only. Nullable.
createdObjectscreatedObjects directoryObject collectiondirectoryObject collection ユーザーによって作成されたディレクトリ オブジェクト。読み取り専用です。Null 許容型。Directory objects that were created by the user. Read-only. Nullable.
directReportsdirectReports directoryObject collectiondirectoryObject collection そのユーザーの部下であるユーザーと連絡先。(マネージャー プロパティがこのユーザーに設定されている、ユーザーと連絡先。)読み取り専用です。Null 許容型。The users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable.
drivedrive drivedrive ユーザーの OneDrive。読み取り専用です。The user's OneDrive. Read-only.
drivesdrives drive コレクションdrive collection このユーザーが使用できるドライブのコレクション。読み取り専用です。A collection of drives available for this user. Read-only.
eventsevents Event collectionEvent collection ユーザーのイベント。既定は、既定の予定表でイベントを表示します。読み取り専用です。Null 許容型。The user's events. Default is to show Events under the Default Calendar. Read-only. Nullable.
extensionsextensions extension コレクションextension collection ユーザーに対して定義されているオープン拡張機能のコレクション。読み取り専用です。Null 許容型。The collection of open extensions defined for the user. Read-only. Nullable.
inferenceClassificationinferenceClassification inferenceClassificationinferenceClassification 明示的な指定に基づく、ユーザーのメッセージの関連性の分類。明示的な指定は、推定される関連性や重要性より優先されます。Relevance classification of the user's messages based on explicit designations which override inferred relevance or importance.
licenseDetailslicenseDetails LicenseDetails コレクションLicenseDetails collection このユーザーのライセンスの詳細のコレクションです。A collection of this user's license details. Null 許容型です。Nullable.
mailFoldersmailFolders MailFolder collectionMailFolder collection ユーザーのメール フォルダー。読み取り専用です。Null 許容型。The user's mail folders. Read-only. Nullable.
managermanager directoryObjectdirectoryObject このユーザーの上司であるユーザーまたは連絡先。読み取り専用です。(HTTP メソッド:GET、PUT、DELETE)The user or contact that is this user’s manager. Read-only. (HTTP Methods: GET, PUT, DELETE.)
memberOfmemberOf directoryObject collectiondirectoryObject collection ユーザーがメンバーになっているグループとディレクトリ ロール。読み取り専用です。Null 許容型。The groups and directory roles that the user is a member of. Read-only. Nullable.
messagesmessages Message collectionMessage collection メールボックスまたはフォルダー内のメッセージ。読み取り専用です。Null 許容型。The messages in a mailbox or folder. Read-only. Nullable.
onenoteonenote OneNoteOnenote 読み取り専用です。Read-only.
outlookoutlook OutlookUserOutlookUser 読み取り専用です。Read-only.
ownedDevicesownedDevices directoryObject collectiondirectoryObject collection ユーザーが所有しているデバイス。読み取り専用です。Null 許容型。Devices that are owned by the user. Read-only. Nullable.
ownedObjectsownedObjects directoryObject collectiondirectoryObject collection ユーザーが所有しているディレクトリ オブジェクト。読み取り専用です。Null 許容型。Directory objects that are owned by the user. Read-only. Nullable.
peoplepeople person コレクションperson collection ユーザーに関連のある人物です。People that are relevant to the user. 読み取り専用です。Read-only. Null 許容型。Nullable.
photophoto profilePhotoprofilePhoto ユーザーのプロフィール写真。読み取り専用です。The user's profile photo. Read-only.
plannerplanner plannerUserplannerUser ユーザーに存在する可能性がある Planner リソースのエントリ ポイントです。Entry-point to the Planner resource that might exist for a user. 読み取り専用です。Read-only.
registeredDevicesregisteredDevices directoryObject collectiondirectoryObject collection ユーザーについて登録されているデバイス。読み取り専用です。Null 許容型。Devices that are registered for the user. Read-only. Nullable.

JSON 表記JSON representation

以下は、リソースの JSON 表記ですHere is a JSON representation of the resource

{
  "aboutMe": "string",
  "accountEnabled": true,
  "ageGroup": "string",
  "assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}],
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "birthday": "String (timestamp)",
  "businessPhones": ["string"],
  "city": "string",
  "companyName": "string",
  "consentProvidedForMinor": "string",
  "country": "string",
  "department": "string",
  "displayName": "string",
  "employeeId": "string",
  "faxNumber" : "string",
  "givenName": "string",
  "hireDate": "String (timestamp)",
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "interests": ["string"],
  "jobTitle": "string",
  "legalAgeGroupClassification": "string",
  "licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
  "mail": "string",
  "mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
  "mailNickname": "string",
  "mobilePhone": "string",
  "mySite": "string",
  "officeLocation": "string",
  "onPremisesDistinguishedName": "string",
  "onPremisesDomainName": "string",
  "onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "onPremisesImmutableId": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSamAccountName": "string",
  "onPremisesSecurityIdentifier": "string",
  "onPremisesSyncEnabled": true,
  "onPremisesUserPrincipalName": "string",
  "otherMails": "string",
  "passwordPolicies": "string",
  "passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
  "pastProjects": ["string"],
  "postalCode": "string",
  "preferredDataLocation": "string",
  "preferredLanguage": "string",
  "preferredName": "string",
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "proxyAddresses": ["string"],
  "responsibilities": ["string"],
  "schools": ["string"],
  "showInAddressList": true,
  "skills": ["string"],
  "state": "string",
  "streetAddress": "string",
  "surname": "string",
  "usageLocation": "string",
  "userPrincipalName": "string",
  "userType": "string",

  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "calendarGroups": [{ "@odata.type": "microsoft.graph.calendarGroup" }],
  "calendarView": [{ "@odata.type": "microsoft.graph.event" }],
  "calendars": [ {"@odata.type": "microsoft.graph.calendar"} ],
  "contacts": [ { "@odata.type": "microsoft.graph.contact" } ],
  "contactFolders": [ { "@odata.type": "microsoft.graph.contactFolder" } ],
  "createdObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "directReports": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" } ],
  "events": [ { "@odata.type": "microsoft.graph.event" } ],
  "inferenceClassification": { "@odata.type": "microsoft.graph.inferenceClassification" },
  "mailFolders": [ { "@odata.type": "microsoft.graph.mailFolder" } ],
  "manager": { "@odata.type": "microsoft.graph.directoryObject" },
  "memberOf": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "messages": [ { "@odata.type": "microsoft.graph.message" } ],
  "outlook": { "@odata.type": "microsoft.graph.outlookUser" },
  "ownedDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "ownedObjects": [ { "@odata.type": "microsoft.graph.directoryObject" } ],
  "photo": { "@odata.type": "microsoft.graph.profilePhoto" },
  "registeredDevices": [ { "@odata.type": "microsoft.graph.directoryObject" } ]
}

関連項目See also