UserPrincipal 類別

定義

命名空間:

System.DirectoryServices.AccountManagement

組件:

System.DirectoryServices.AccountManagement.dll

套件:

System.DirectoryServices.AccountManagement v11.0.0-preview.5.26302.115

來源:

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

建構函式

名稱	Description
UserPrincipal(PrincipalContext, String, String, Boolean)	使用指定的內容、SAM 帳戶名稱、密碼和啟用值，初始化 UserPrincipal 類別的新實例。
UserPrincipal(PrincipalContext)	使用指定的內容，初始化 UserPrincipal 類別的新實例。

屬性

名稱	Description
AccountExpirationDate	取得或設定一個 Nullable DateTime ，指定帳號到期的日期和時間。 (繼承來源 AuthenticablePrincipal)
AccountLockoutTime	取得 Nullable DateTime ，指定帳號被鎖定的日期和時間。 (繼承來源 AuthenticablePrincipal)
AdvancedSearchFilter	回傳 AdvancedFilters 一個物件以設定唯讀屬性，然後再將該物件傳給 PrincipalSearcher。
AllowReversiblePasswordEncryption	取得或設定一個布林值，指定該帳號是否啟用可逆密碼加密。 (繼承來源 AuthenticablePrincipal)
BadLogonCount	會用錯誤的憑證取得該帳號的登入次數。 (繼承來源 AuthenticablePrincipal)
Certificates	會拿到 X509Certificate2Collection 包含該帳號 X509 憑證的檔案。 (繼承來源 AuthenticablePrincipal)
Context	會得到與該主體相關聯的主體上下文。 (繼承來源 Principal)
ContextRaw	會得到與該主體相關的主上下文。 (繼承來源 Principal)
ContextType	取得上下文類型列舉值，指定與此主體相關的主要上下文類型。 (繼承來源 Principal)
Current	取得一個代表執行緒目前使用者的使用者主體物件。
DelegationPermitted	取得或設定一個可空的布林值，指定該帳號是否可以被委派。 (繼承來源 AuthenticablePrincipal)
Description	取得或設定委託人的描述。 (繼承來源 Principal)
DisplayName	取得或設定此主體的顯示名稱。 (繼承來源 Principal)
DistinguishedName	因此獲得了這個重要名稱（DN）。 (繼承來源 Principal)
EmailAddress	取得或設定這個帳號的電子郵件地址。
EmployeeId	取得或設定這個使用者主體的員工ID。
Enabled	取得或設定一個可空的布林值，指定該帳號是否啟用用於驗證。 (繼承來源 AuthenticablePrincipal)
GivenName	取得或設定使用者主體的名稱。
Guid	會讓這個原則綁定 GUID。 (繼承來源 Principal)
HomeDirectory	取得或設定這個帳號的主目錄。 (繼承來源 AuthenticablePrincipal)
HomeDrive	取得或設定這個帳號的家用硬碟。 (繼承來源 AuthenticablePrincipal)
LastBadPasswordAttempt	取得 Nullable DateTime ，指定該帳號最後一次錯誤密碼嘗試的日期與時間。 (繼承來源 AuthenticablePrincipal)
LastLogon	取得可取消的 Nullable DateTime ，指定該帳號最後登入的日期與時間。 (繼承來源 AuthenticablePrincipal)
LastPasswordSet	取得 Nullable 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	取得或設定使用者主體的語音電話號碼。

方法

名稱	Description
ChangePassword(String, String)	把帳號密碼從舊密碼改成新密碼。 不要用 ComputerPrincipal. (繼承來源 AuthenticablePrincipal)
CheckDisposedOrDeleted()	判斷該類別是否 Dispose() 已呼叫 or 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)
GetUnderlyingObject()	回傳提供主物件接觸資料的底層 DirectoryEntry 物件。 (繼承來源 Principal)
GetUnderlyingObjectType()	回傳底層物件類型。 (繼承來源 Principal)
IsAccountLockedOut()	回傳一個布林值，指定該帳戶目前是否被鎖定。 (繼承來源 AuthenticablePrincipal)
IsMemberOf(GroupPrincipal)	回傳一個布林值，指定主體是否屬於指定群。 (繼承來源 Principal)
IsMemberOf(PrincipalContext, IdentityType, String)	回傳一個布林值，指定主體是否屬於由單位元類型與值指定的群組成員。 (繼承來源 Principal)
RefreshExpiredPassword()	刷新過期的密碼。 (繼承來源 AuthenticablePrincipal)
Save()	這樣可以保存對儲存主要物件所做的變更。 如果這是新的主物件，這個方法會將其插入儲存。 (繼承來源 Principal)
Save(PrincipalContext)	這樣可以保存對儲存主要物件所做的變更。 若此為新的主物件，此方法將它插入指定的上下文中。 如果主體已經被持久化，則會從原始上下文移至指定的上下文。 (繼承來源 Principal)
SetPassword(String)	將帳號密碼設定為指定的值。 (繼承來源 AuthenticablePrincipal)
ToString()	回傳一個使用者友善的字串表示，表示目前的主要物件。 (繼承來源 Principal)
UnlockAccount()	如果帳號目前被鎖定，則會解鎖。 (繼承來源 AuthenticablePrincipal)