New-SCUserRole
Cria uma função de utilizador para um grupo de utilizadores 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
O cmdlet New-SCUserRole cria uma função de utilizador para um grupo de utilizadores do Virtual Machine Manager (VMM). Pode criar as seguintes funções de utilizador: Administrador Delegado, Administrador Read-Only, Administrador de Máquina Virtual e utilizador Self-Service. Só existe uma função de administrador. Não é possível criar outra função de Administrador ou eliminar a existente.
Se for membro de uma função de utilizador do Administrador Delegado, pode criar uma função de utilizador. No entanto, o âmbito da nova função de utilizador deve ser um subconjunto do âmbito da sua função de utilizador-mãe.
Depois de criar uma função de utilizador, pode utilizar o cmdlet Set-SCUserRole para renomear a função de utilizador, adicionar ou remover membros, e adicionar ou modificar o âmbito de aplicação dos objetos que os membros da função podem gerir. Para uma Self-Service função de utilizador, pode especificar quais as ações que os membros de uma Self-Service papel de utilizador podem assumir nas suas máquinas virtuais, e pode definir uma quota que limita o número de máquinas virtuais que os utilizadores de self-service podem criar. Embora não possa criar ou remover a função de Administrador ou limitar o seu âmbito de aplicação, pode utilizar o Set-SCUserRole para adicionar ou remover membros a essa função.
Para obter informações sobre como modificar as propriedades de uma função de utilizador, escreva Get-Help Set-SCUserRole.
Exemplos
Exemplo 1: Criar uma função de utilizador delegado do administrador
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Este comando cria uma função de utilizador de administrador delegada chamada ContosoDelegatedAdmin, fornece a descrição Administradores Delegados para o domínio Contoso.com, e utiliza o parâmetro UserRoleProfile para designar o tipo de função de utilizador como Administrador Delegado.
Exemplo 2: Criar uma função de utilizador self service
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Este comando cria uma nova função de utilizador chamada ContosoSelfServiceUsers, utiliza o parâmetro UserRoleProfile para designar o novo tipo de função do utilizador como utilizador Self-Service e armazena o novo objeto de função do utilizador na variável $SelfServiceRole.
Exemplo 3: Criar uma função de administrador de máquina virtual
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Este comando cria uma função de utilizador de administrador de máquina virtual chamada VirtualMachineAdmin, fornece a descrição "Administrador de Máquina Virtual para contoso.com domínio" e utiliza o parâmetro UserRoleProfile para designar o tipo de função do utilizador como VMAdmin.
Parâmetros
-Description
Especifica uma descrição para a função de utilizador.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Especifica o ID único para a nova função de utilizador.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Especifica um identificador para uma série de comandos que funciona como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica uma variável em que o progresso do trabalho é rastreado e armazenado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica um nome para a nova função de utilizador.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentUserRole
Especifica uma função de utilizador VMM existente como o pai da nova função de utilizador.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar as dicas PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleProfile
Especifica o tipo de perfil que é a base para a nova função de utilizador. Os valores aceitáveis para este parâmetro são:
- DelegadoAdmin
- ReadOnlyAdmin
- SelfServiceUser
- InquilinoAdmin
- 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 o servidor VMM no qual este cmdlet cria uma função de utilizador.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
UserRole
Este cmdlet devolve um objeto UserRole .