Partager via

Person

  • Article

Stores information about a user.

Schema

<?xml version="1.0"?><xs:schema xmlns:rm="https://schemas.microsoft.com/2006/11/ResourceManagement" targetNamespace="https://schemas.microsoft.com/2006/11/ResourceManagement" version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexType name="Person">
    <xs:sequence>
      <xs:element minOccurs="0" name="ObjectID" type="rm:ReferenceType" />
      <xs:element minOccurs="1" name="ObjectType">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="1" name="CreatedTime" type="xs:dateTime" />
      <xs:element minOccurs="0" name="Creator" type="rm:ReferenceType" />
      <xs:element minOccurs="0" name="MVObjectID">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="DeletedTime" type="xs:dateTime" />
      <xs:element minOccurs="0" name="Description">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="DetectedRulesList" type="rm:ReferenceCollectionType" />
      <xs:element minOccurs="0" name="DisplayName">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="ExpectedRulesList" type="rm:ReferenceCollectionType" />
      <xs:element minOccurs="0" name="ExpirationTime" type="xs:dateTime" />
      <xs:element minOccurs="0" name="Locale">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="ResourceTime" type="xs:dateTime" />
      <xs:element minOccurs="0" name="AccountName">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value="^[^&quot;/\\[\]:;|=,+/*?&lt;&gt;]{1,64}$" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="Domain">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="AD_UserCannotChangePassword" type="xs:boolean" />
      <xs:element minOccurs="0" name="Address">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="Assistant" type="rm:ReferenceType" />
      <xs:element minOccurs="0" name="AuthNWFLockedOut" type="rm:ReferenceCollectionType" />
      <xs:element minOccurs="0" name="AuthNLockoutRegistrationID" type="rm:ReferenceCollectionType" />
      <xs:element minOccurs="0" name="AuthNWFRegistered" type="rm:ReferenceCollectionType" />
      <xs:element minOccurs="0" name="City">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="Company">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="CostCenter">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="CostCenterName">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="Country">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="Department">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="DomainConfiguration" type="rm:ReferenceType" />
      <xs:element minOccurs="0" name="Email">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="EmployeeEndDate" type="xs:dateTime" />
      <xs:element minOccurs="0" name="EmployeeID">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="EmployeeStartDate" type="xs:dateTime" />
      <xs:element minOccurs="0" name="EmployeeType">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value="^(Contractor|Intern|Full Time Employee)?$" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="FirstName">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="FreezeCount" type="xs:integer" />
      <xs:element minOccurs="0" name="FreezeLevel">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="IsRASEnabled" type="xs:boolean" />
      <xs:element minOccurs="0" name="JobTitle">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="LastName">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="LastResetAttemptTime" type="xs:dateTime" />
      <xs:element minOccurs="0" name="LoginName">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="MailNickname">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value="^[^@ ]{1,64}$" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="Manager" type="rm:ReferenceType" />
      <xs:element minOccurs="0" name="MiddleName">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="MobilePhone">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="ObjectSID" type="xs:base64Binary" />
      <xs:element minOccurs="0" name="OfficeFax">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="OfficeLocation">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="OfficePhone">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="Photo" type="xs:base64Binary" />
      <xs:element minOccurs="0" name="PostalCode">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="ProxyAddressCollection" type="rm:StringCollectionType" />
      <xs:element minOccurs="0" name="Register" type="xs:boolean" />
      <xs:element minOccurs="0" name="RegistrationRequired" type="xs:boolean" />
      <xs:element minOccurs="0" name="ResetPassword">
        <xs:simpleType>
          <xs:restriction base="xs:string">
            <xs:pattern value=".{0,448}" />
          </xs:restriction>
        </xs:simpleType>
      </xs:element>
      <xs:element minOccurs="0" name="SIDHistory" type="rm:BinaryCollectionType" />
      <xs:element minOccurs="0" name="TimeZone" type="rm:ReferenceType" />
    </xs:sequence>
  </xs:complexType>
</xs:schema>

Properties

The following table lists the properties of the Person resource.

Property Description

AccountName

Optional String property. Login name of the user.

AD_UserCannotChangePassword

Optional Boolean property. If true, FIM will use synchronize information from Active Directory (AD) to determine whether the user is allowed to change their AD password.

Address

Optional String property. Mailing address for the user.

Assistant

Optional property. Reference to a Person resource who is a secretary for this user.

AuthNLockoutRegistrationID

Optional multi-valued property. Reference to a GateRegistration resource that represents the lockout gate registration data.

AuthNWFLockedOut

Optional multi-valued property. Reference to a WorkflowDefinition resource that represents an authentication workflow to which the user is locked out.

AuthNWFRegistered

Optional multi-valued property. Reference to a WorkflowDefinition resource that represents an authentication workflow for which a user is registered.

City

Optional String property. City of the user's given address.

Company

Optional String property. Name of the user's company.

CostCenter

Optional String property. User's cost center, a non-revenue-producing element of an organization, where costs are separately figured and allocated.

CostCenterName

Optional String property. Cost center name.

Country

Optional String property. Country/region of the user's given address.

Department

Optional String property. Department name.

Domain

Optional String property. Domain where the Person resource will be created.

DomainConfiguration

Optional property of type ReferenceType. A reference to the parent Domain resource for this resource.

Email

Optional String property. Primary e-mail address for the user.

EmployeeEndDate

Optional property. DateTime value that specifies when the user left the company.

EmployeeID

Optional String property. Unique identifier for the employee.

EmployeeStartDate

Optional property. DateTime value that specifies when the user started working at the company.

EmployeeType

Optional String property. Employee type. Valid values are:

Contract

Intern

Full Time Employee

FirstName

Optional property. First name of the user.

FreezeCount

(This property is not used.)

FreezeLevel

(This property is not used.)

IsRASEnabled

Optional Boolean value. Indicates if user is able to access FIM through a Remote Access Service (RAS).

JobTitle

Optional String property. Formal job title of the user.

LastName

Optional String property. Last name of the user.

LastResetAttemptTime

(This property is not used.)

LoginName

Optional String property. Login name for the user. This is typically a combination of domain/alias.

MailNickname

Optional String property. Alias of the user's mailbox. This is also used to create an e-mail address.

Manager

Optional property. Reference to a Person resource that represents the manager of the user.

MiddleName

Optional String property. Middle name of the user.

MobilePhone

Optional String property. Mobile telephone number with area code or country/region and local area codes separated.

ObjectSID

Optional property of type base64Binary. A binary value that specifies the security identifier (SID) of the user. The SID is a unique value used to identify the user as a security principal.

OfficeFax

Optional String property. Fax number with area code or country/region and local area codes separated.

OfficeLocation

Optional String property. Physical address of the user's office.

OfficePhone

Optional String property. Office telephone number with area code or country/region and local area codes separated.

Photo

Optional property. User photo in Binary format. Photo can be displayed in the user interface.

PostalCode

Optional String property. The postal or zip code for the user’s office.

ProxyAddressCollection

Optional multi-valued String property. Address of a proxy for the user.

Register

Optional Boolean property. This property is used to initiate and store the registration.

RegistrationRequired

(This property is not used.)

ResetPassword

Optional String property. This is used to trigger an authentication workflow on a WS-Transfer Put operation. The password itself is not stored.

SIDHistory

Optional multi-valued property of type BinaryCollectionType. Contains previous SIDs used for the resource if the resource was moved from another domain.

TimeZone

Optional property. Reference to a TimeZoneConfiguration resource. If this value is specified on a Person resource it will override the default time zone information specified in PortalUIConfiguration.

Parent Elements

None

Remarks

All of the resource types in FIM have the same attribute bindings as the Resource type by default. For more information, see Forefront Identity Manager Schema.

See Also

Concepts

Schema Data Types
How to: Retrieve the FIM Service Schema Using WS-MetadataExchange
Web Services Overview

Other Resources

Forefront Identity Manager Schema