UserPrincipal.FindByIdentity メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された ID 値と一致するユーザー プリンシパル オブジェクトを返します。
オーバーロード
| FindByIdentity(PrincipalContext, IdentityType, String) |
指定された ID の種類および値と一致するユーザー プリンシパル オブジェクトを返します。 このバージョンの FindByIdentity メソッドでは、ID 値の形式が指定されます。 |
| FindByIdentity(PrincipalContext, String) |
指定された ID 値と一致するユーザー プリンシパル オブジェクトを返します。 |
FindByIdentity(PrincipalContext, IdentityType, String)
- ソース:
- User.cs
- ソース:
- User.cs
- ソース:
- User.cs
指定された ID の種類および値と一致するユーザー プリンシパル オブジェクトを返します。 このバージョンの FindByIdentity メソッドでは、ID 値の形式が指定されます。
public:
static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> System.DirectoryServices.AccountManagement.UserPrincipalPublic Shared Function FindByIdentity (context As PrincipalContext, identityType As IdentityType, identityValue As String) As UserPrincipalパラメーター
- context
- PrincipalContext
操作が実行されるサーバーまたはドメインを指定する PrincipalContext。
- identityType
- IdentityType
identityValue パラメーターの形式を指定する IdentityType 列挙値。
- identityValue
- String
ユーザー プリンシパルの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。
戻り値
指定された ID の値と型に一致する UserPrincipal オブジェクト。一致するオブジェクトが検出されなかった場合は null。
例外
現在のユーザー オブジェクトと一致する複数のユーザー プリンシパル オブジェクトが見つかりました。
ID の値は有効な IdentityType 列挙値ではありません。
例
次のコードは、ローカル コンピューター ストアに接続します。 資格情報はコンストラクターで PrincipalContext 指定されていないため、現在のスレッドを実行しているユーザーの資格情報が使用されます。
SamAccountName "Guest" を持つユーザーを検索する検索が実行されます。
ユーザーが見つかった場合は、このユーザーのアカウントが有効になっているかどうかを判断するためにチェックが実行されます。 アカウントが有効になっていない場合は、コード例で有効にします。
PrincipalContext ctx = new PrincipalContext(ContextType.Machine);
UserPrincipal usr = UserPrincipal.FindByIdentity(ctx,
IdentityType.SamAccountName,
"Guest");
if(usr != null)
{
if (usr.Enabled == false)
usr.Enabled = true;
usr.Save();
usr.Dispose();
}
ctx.Dispose();
適用対象
FindByIdentity(PrincipalContext, String)
- ソース:
- User.cs
- ソース:
- User.cs
- ソース:
- User.cs
指定された ID 値と一致するユーザー プリンシパル オブジェクトを返します。
public:
static System::DirectoryServices::AccountManagement::UserPrincipal ^ FindByIdentity(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::String ^ identityValue);public static System.DirectoryServices.AccountManagement.UserPrincipal FindByIdentity (System.DirectoryServices.AccountManagement.PrincipalContext context, string identityValue);static member FindByIdentity : System.DirectoryServices.AccountManagement.PrincipalContext * string -> System.DirectoryServices.AccountManagement.UserPrincipalPublic Shared Function FindByIdentity (context As PrincipalContext, identityValue As String) As UserPrincipalパラメーター
- context
- PrincipalContext
操作が実行されるサーバーまたはドメインを指定する PrincipalContext。
- identityValue
- String
ユーザー プリンシパルの ID。 このパラメーターは、 IdentityType 列挙体に含まれるいずれの形式に指定することもできます。
戻り値
UserPrincipal オブジェクト。指定した ID の値と一致し、一致する値が見つからない場合は null になります。
例外
現在のユーザー オブジェクトと一致する複数のユーザー プリンシパル オブジェクトが見つかりました。
適用対象
.NET