ManagementAuthorization.Grant(String, String, Boolean) Método

Definición

Espacio de nombres:

Microsoft.Web.Management.Server

Ensamblado:

Microsoft.Web.Management.dll

Concede autorización a un nombre de usuario o rol para la ruta de acceso de configuración especificada.

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

Parámetros

name

String

Nombre de usuario al que se va a conceder permiso.

configurationPath

String

Ruta de acceso de configuración para la que se concederá autorización.

isRole

Boolean

true es para indicar que el valor especificado en el name parámetro es un rol de seguridad; en caso contrario, false.

Devoluciones

ManagementAuthorizationInfo

Un objeto ManagementAuthorizationInfo.

Excepciones

ArgumentNullException

El valor de name es null o está vacío.

Ejemplos

En el siguiente ejemplo se muestra el Grant método. En este ejemplo se comprueba si el usuario especificado ya está en la colección de usuarios autorizados. Si el usuario aún no está en la colección, el Grant método concede autorización al usuario. Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase 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;

Comentarios

Este método inserta un usuario en la colección de usuarios autorizados para la ruta de acceso especificada. Después de conceder permiso al usuario al sitio, el usuario se incluye en la colección devuelta por el GetAuthorizedUsers método y en la lista de usuarios de la página Permisos del administrador de IIS en el Administrador de IIS.

Este método construye un nuevo ManagementAuthorizationInfo objeto que tiene los valores de nameparámetro , configurationPathy isRole . La concesión de autorización a un usuario modifica el archivo Administration.config.

Si se intenta conceder autorización a un usuario que ya está en la colección authorized-users, se producirá una excepción.