共用方式為


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

傳回 AdvancedFilters 物件,先設定唯讀屬性,然後再將物件傳遞至 PrincipalSearcher

AllowReversiblePasswordEncryption

取得或設定布林值,這個值指定是否針對此帳戶啟用可以復原的密碼加密。

(繼承來源 AuthenticablePrincipal)
BadLogonCount

取得嘗試用不正確的認證登入這個帳戶的次數。

(繼承來源 AuthenticablePrincipal)
Certificates

取得 X509Certificate2Collection,其中包含此帳戶的 X509 憑證。

(繼承來源 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

取得主體的安全識別項 (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)

在擴充類別中設定屬性 (Attribute) 的值。

(繼承來源 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)

適用於