ManagementAuthorization.Grant(String, String, Boolean) メソッド

定義

名前空間:

Microsoft.Web.Management.Server

アセンブリ:

Microsoft.Web.Management.dll

指定した構成パスのユーザー名またはロールに対する承認を付与します。

public:
 static Microsoft::Web::Management::Server::ManagementAuthorizationInfo ^ Grant(System::String ^ name, System::String ^ configurationPath, bool isRole);

public static Microsoft.Web.Management.Server.ManagementAuthorizationInfo Grant (string name, string configurationPath, bool isRole);

static member Grant : string * string * bool -> Microsoft.Web.Management.Server.ManagementAuthorizationInfo

Public Shared Function Grant (name As String, configurationPath As String, isRole As Boolean) As ManagementAuthorizationInfo

パラメーター

name

String

アクセス許可を付与するユーザー名。

configurationPath

String

承認が付与される構成パス。

isRole

Boolean

true パラメーターで name 指定された値がセキュリティ ロールであることを示す場合は 。それ以外の場合 falseは 。

戻り値

ManagementAuthorizationInfo

ManagementAuthorizationInfo オブジェクト。

例外

ArgumentNullException

name が null または空です。

例

Grantメソッドの例を次に示します。 次の使用例は、指定されたユーザーが既に承認されたユーザーのコレクション内にあるかどうかを確認します。 ユーザーがコレクションにまだ存在しない場合、メソッドは Grant ユーザーに承認を付与します。 このコード例は、ManagementAuthorization クラスのために提供されている大規模な例の一部です。

// Grant the user permission to this site only if 
// they are not already in the allowed users collection.
if (!isInCollection)
{
    ManagementAuthorization.Grant(userName, path, false);
    message = message + "\nadded: " + userName;
}
display = display + message;

注釈

このメソッドは、指定したパスの承認されたユーザーのコレクションにユーザーを挿入します。 ユーザーにサイトへのアクセス許可が付与されると、 メソッドによって GetAuthorizedUsers 返されるコレクションと、 IIS マネージャーの [IIS マネージャーのアクセス許可] ページのユーザーの一覧にユーザーが含まれます。

このメソッドは、および パラメーター値をconfigurationPathname持つ新しいManagementAuthorizationInfoオブジェクトをisRole構築します。 ユーザーに承認を付与すると、Administration.config ファイルが変更されます。

既に authorized-users コレクションに属しているユーザーに承認を付与しようとすると、例外がスローされます。