New-SCUserRole
Crea un rol de usuario para un grupo de usuarios de VMM.
Sintaxis
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 de 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 adoptar 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áquinas virtuales 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ID
Especifica el identificador único para el nuevo rol de usuario.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JobVariable
Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifica un nombre para el nuevo rol de usuario.
| Tipo: | String |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OnBehalfOfUserRole
Especifica un rol de usuario.
Para obtener un rol de usuario, use el cmdlet
| Tipo: | UserRole |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ParentUserRole
Especifica un rol de usuario VMM existente como elemento primario del nuevo rol de usuario.
| Tipo: | UserRole |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PROTipID
Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar las sugerencias pro.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UserRoleProfile
Especifica el tipo de perfil que es la base para el nuevo rol de usuario. Los valores aceptables para este parámetro son:
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Tipo: | Profile |
| Valores aceptados: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VMMServer
Especifica el servidor VMM en el que este cmdlet crea un rol de usuario.
| Tipo: | ServerConnection |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
Salidas
UserRole
Este cmdlet devuelve un objeto UserRole.