UserPrincipal 类

定义

封装作为用户帐户的主体。

public ref class UserPrincipal : System::DirectoryServices::AccountManagement::AuthenticablePrincipal
[System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")]
public class UserPrincipal : System.DirectoryServices.AccountManagement.AuthenticablePrincipal
[System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")]
[System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)]
public class UserPrincipal : System.DirectoryServices.AccountManagement.AuthenticablePrincipal
[<System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")>]
type UserPrincipal = class
    inherit AuthenticablePrincipal
[<System.DirectoryServices.AccountManagement.DirectoryRdnPrefix("CN")>]
[<System.Security.SecurityCritical(System.Security.SecurityCriticalScope.Everything)>]
type UserPrincipal = class
    inherit AuthenticablePrincipal
Public Class UserPrincipal
Inherits AuthenticablePrincipal
继承
属性

构造函数

UserPrincipal(PrincipalContext)

使用指定的上下文初始化 UserPrincipal 类的新实例。

UserPrincipal(PrincipalContext, String, String, Boolean)

使用指定的上下文、SAM 帐户名、密码和启用的值初始化 UserPrincipal 类的新实例。

属性

AccountExpirationDate

获取或设置一个可以为 null 的 DateTime,用于指定帐户过期的日期和时间。

(继承自 AuthenticablePrincipal)
AccountLockoutTime

获取一个可以为 null 的 DateTime,用于指定帐户被锁定的日期和时间。

(继承自 AuthenticablePrincipal)
AdvancedSearchFilter

在将对象传递给 PrincipalSearcher 之前,返回 AdvancedFilters 对象以设置只读属性。

AllowReversiblePasswordEncryption

获取或设置一个布尔值,该值指定是否为此帐户启用可逆密码加密。

(继承自 AuthenticablePrincipal)
BadLogonCount

获取对此帐户使用不正确的凭据进行登录的尝试次数。

(继承自 AuthenticablePrincipal)
Certificates

获取包含此账户的 X509 证书的 X509Certificate2Collection

(继承自 AuthenticablePrincipal)
Context

获取与主体关联的主体上下文。

(继承自 Principal)
ContextRaw

获取与此主体关联的主体上下文。

(继承自 Principal)
ContextType

获取上下文类型枚举值,该值指定与此主体关联的主体上下文的类型。

(继承自 Principal)
Current

获取一个用户主体对象,该对象表示运行线程的当前用户。

DelegationPermitted

获取或设置一个可以为 null 的布尔值,该值指定是否可以委托帐户。

(继承自 AuthenticablePrincipal)
Description

获取或设置主体的说明。

(继承自 Principal)
DisplayName

获取或设置此主体的显示名称。

(继承自 Principal)
DistinguishedName

获取此主体的可分辨名称 (DN)。

(继承自 Principal)
EmailAddress

获取或设置此帐户的电子邮件地址。

EmployeeId

获取或设置此用户主体的雇员 ID。

Enabled

获取或设置一个可以为 null 的布尔值,该值指定是否支持此帐户进行身份验证。

(继承自 AuthenticablePrincipal)
GivenName

获取或设置用户主体的名字。

Guid

获取与此主体关联的 GUID。

(继承自 Principal)
HomeDirectory

获取或设置此帐户的主目录。

(继承自 AuthenticablePrincipal)
HomeDrive

获取或设置此帐户的主驱动器。

(继承自 AuthenticablePrincipal)
LastBadPasswordAttempt

获取一个可以为 null 的 DateTime,用于指定最后一次对此帐户进行不正确的密码尝试的日期和时间。

(继承自 AuthenticablePrincipal)
LastLogon

获取一个可以为 null 的 DateTime,用于指定最后一次登录此帐户的日期和时间。

(继承自 AuthenticablePrincipal)
LastPasswordSet

获取一个可以为 null 的 DateTime,用于指定最后一次为此帐户设置密码的日期和时间。

(继承自 AuthenticablePrincipal)
MiddleName

获取或设置用户主体的中间名。

Name

获取或设置此主体的名称。

(继承自 Principal)
PasswordNeverExpires

获取或设置一个布尔值,该值指定此帐户的密码是否会过期。

(继承自 AuthenticablePrincipal)
PasswordNotRequired

获取或设置一个布尔值,该值指定此帐户是否需要密码。

(继承自 AuthenticablePrincipal)
PermittedLogonTimes

获取或设置主体可以登录的次数。

(继承自 AuthenticablePrincipal)
PermittedWorkstations

获取允许此主体登录的工作站的列表。

(继承自 AuthenticablePrincipal)
SamAccountName

获取或设置此主体的 SAM 帐户名。

(继承自 Principal)
ScriptPath

获取或设置此帐户的脚本路径。

(继承自 AuthenticablePrincipal)
Sid

获取主体的安全 ID (SID)。

(继承自 Principal)
SmartcardLogonRequired

获取或设置一个布尔值,该值指定登录帐户是否需要智能卡。

(继承自 AuthenticablePrincipal)
StructuralObjectClass

获取结构对象类目录特性。

(继承自 Principal)
Surname

获取或设置用户主体的姓氏。

UserCannotChangePassword

获取或设置一个布尔值,指定用户是否可以更改此帐户的密码。 请勿将其与 ComputerPrincipal 一起使用。

(继承自 AuthenticablePrincipal)
UserPrincipalName

获取或设置与此主体关联的用户主体名称 (UPN)。

(继承自 Principal)
VoiceTelephoneNumber

获取或设置用户主体的语音电话号码。

方法

ChangePassword(String, String)

将帐户旧密码更改为新密码。 请勿将其与 ComputerPrincipal 一起使用。

(继承自 AuthenticablePrincipal)
CheckDisposedOrDeleted()

确定是否已对此类调用 Dispose()Delete() 方法。 此方法由从此主体类派生的类调用。

(继承自 Principal)
Delete()

从存储区中删除主体对象。

(继承自 Principal)
Dispose()

处置 Principal 对象的当前实例。

(继承自 Principal)
Equals(Object)

返回一个布尔值,该值指定提供的对象是否等于当前对象。

(继承自 Principal)
ExpirePasswordNow()

使此帐户的密码过期。 这会强制用户在下次登录时更改其密码。

(继承自 AuthenticablePrincipal)
ExtensionGet(String)

检索扩展类对象的属性。

(继承自 Principal)
ExtensionSet(String, Object)

设置扩展类中特性的值。

(继承自 Principal)
FindByBadPasswordAttempt(PrincipalContext, DateTime, MatchType)

对于在指定日期和时间范围内有错误密码尝试记录的用户,返回 PrincipalSearchResult<T> 对象集合。

FindByExpirationTime(PrincipalContext, DateTime, MatchType)

返回用户的 PrincipalSearchResult<T> 对象集合,其具有指定日期和时间范围内的帐户过期时间。

FindByIdentity(PrincipalContext, IdentityType, String)

返回与指定标识类型相匹配的用户主体对象和值。 此版本的 FindByIdentity 方法确定标识值的格式。

FindByIdentity(PrincipalContext, String)

返回与指定标识值相匹配的用户主体对象。

FindByLockoutTime(PrincipalContext, DateTime, MatchType)

对于具有指定日期和时间范围内的帐户锁定时间的用户,返回 PrincipalSearchResult<T> 对象集合。

FindByLogonTime(PrincipalContext, DateTime, MatchType)

为用户返回 PrincipalSearchResult<T> 对象的集合,这些用户在指定日期和时间范围内记录帐户登录。

FindByPasswordSetTime(PrincipalContext, DateTime, MatchType)

返回用户的 PrincipalSearchResult<T> 对象集合,该用户在指定日期和时间范围内设置了密码。

GetAuthorizationGroups()

返回包含所有授权组(该用户是其中的成员)的主体对象的集合。 此函数仅返回安全组;不返回通讯组。

GetGroups()

返回组对象的集合,这些对象指定当前主体是其成员的组。

(继承自 Principal)
GetGroups(PrincipalContext)

返回组对象的集合,主体是这些对象的成员,并且这些对象存在于由指定的上下文参数提供的存储区中。

(继承自 Principal)
GetHashCode()

检索从主体对象的内容创建的哈希,适合在哈希算法和哈希表这样的数据结构中使用。

(继承自 Principal)
GetType()

获取当前实例的 Type

(继承自 Object)
GetUnderlyingObject()

返回基础 DirectoryEntry 对象,其将提供主体对象的联系人数据。

(继承自 Principal)
GetUnderlyingObjectType()

返回基础对象类型。

(继承自 Principal)
IsAccountLockedOut()

返回一个布尔值,该值指定帐户当前是否处于锁定状态。

(继承自 AuthenticablePrincipal)
IsMemberOf(GroupPrincipal)

返回一个布尔值,该值指定该主体是否是指定组的成员。

(继承自 Principal)
IsMemberOf(PrincipalContext, IdentityType, String)

返回一个布尔值,该值指定该主体是否是由标识类型和值指定的组的成员。

(继承自 Principal)
MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
RefreshExpiredPassword()

刷新过期的密码。

(继承自 AuthenticablePrincipal)
Save()

将对主体对象所做的更改保存到存储区中。 如果它是一个新主体对象,则此方法会将其插入到存储区中。

(继承自 Principal)
Save(PrincipalContext)

将对主体对象所做的更改保存到存储区中。 如果它是一个新主体对象,则此方法会将其插入到指定上下文中。 如果已保持主体,则会将该主体从原来的上下文移动到指定的上下文中。

(继承自 Principal)
SetPassword(String)

将帐户密码设置为指定的值。

(继承自 AuthenticablePrincipal)
ToString()

返回当前主体对象的用户友好字符串表示形式。

(继承自 Principal)
UnlockAccount()

如果当前帐户已锁定,则解锁该帐户。

(继承自 AuthenticablePrincipal)

适用于