New-SCUserRole
Crea un rol de usuario para un grupo de usuarios de VMM.
Syntax
New-SCUserRole
[-VMMServer <ServerConnection>]
[-Name] <String>
-UserRoleProfile <Profile>
[-ID <Guid>]
[-JobGroup <Guid>]
[-Description <String>]
[-ParentUserRole <UserRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
El cmdlet New-SCUserRole crea un rol de usuario para un grupo de usuarios de Virtual Machine Manager (VMM). Puede crear los siguientes roles de usuario: Administrador delegado, administrador Read-Only, administrador de máquinas virtuales y usuario de Self-Service. Solo existe un rol de administrador. No puede crear otro rol de administrador ni eliminar el existente.
Si es miembro de un rol de usuario Administrador delegado, puede crear un rol de usuario. Sin embargo, el ámbito del nuevo rol de usuario debe ser un subconjunto del ámbito de su rol de usuario primario.
Después de crear un rol de usuario, puede usar el cmdlet Set-SCUserRole para cambiar el nombre del rol de usuario, agregar o quitar miembros y agregar o modificar el ámbito de los objetos que los miembros del rol pueden administrar. Para un rol de usuario de Self-Service, puede especificar qué acciones pueden asumir los miembros de un rol de usuario de Self-Service en sus máquinas virtuales y puede definir una cuota que limite el número de usuarios de autoservicio de máquinas virtuales. Aunque no puede crear o quitar el rol Administrador o limitar su ámbito, puede usar Set-SCUserRole para agregar o quitar miembros a ese rol.
Para obtener información sobre cómo modificar las propiedades de un rol de usuario, escriba Get-Help Set-SCUserRole.
Ejemplos
Ejemplo 1: Crear un rol de usuario administrador delegado
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Este comando crea un rol de usuario de administrador delegado denominado ContosoDelegatedAdmin, proporciona la descripción Administradores delegados para el dominio de Contoso.com y usa el parámetro UserRoleProfile para designar el tipo de rol de usuario como Administrador delegado.
Ejemplo 2: Creación de un rol de usuario de autoservicio
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Este comando crea un nuevo rol de usuario denominado ContosoSelfServiceUsers, usa el parámetro UserRoleProfile para designar el nuevo tipo de rol de usuario como usuario Self-Service y almacena el nuevo objeto de rol de usuario en la variable $SelfServiceRole.
Ejemplo 3: Creación de un rol de administrador de máquinas virtuales
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Este comando crea un rol de usuario administrador de máquina virtual denominado VirtualMachineAdmin, proporciona la descripción "Administrador de máquina virtual para contoso.com dominio" y usa el parámetro UserRoleProfile para designar el tipo de rol de usuario como VMAdmin.
Parámetros
-Description
Especifica una descripción para el rol de usuario.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Especifica el identificador único para el nuevo rol de usuario.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Especifica un identificador para una serie de comandos que se ejecuta como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica un nombre para el nuevo rol de usuario.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole . Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentUserRole
Especifica un rol de usuario de VMM existente como elemento primario del nuevo rol de usuario.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar las sugerencias pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
Especifica el tipo de perfil que es la base para el nuevo rol de usuario. Los valores permitidos para este parámetro son los siguientes:
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Type: | Profile |
| Accepted values: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica el servidor VMM en el que este cmdlet crea un rol de usuario.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Salidas
UserRole
Este cmdlet devuelve un objeto UserRole .