UserPrincipal 類別

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v8.0.0

來源:

User.cs

封裝本身為使用者帳戶的主體。

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")>]
type UserPrincipal = class
    inherit AuthenticablePrincipal

Public Class UserPrincipal
Inherits AuthenticablePrincipal

繼承

Object

Principal

AuthenticablePrincipal

UserPrincipal

屬性

DirectoryRdnPrefixAttribute

建構函式

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)