New-SCUserRole
Cria uma função de usuário para um grupo de usuários do VMM.
Sintaxe
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 usuário para um grupo de usuários do Virtual Machine Manager (VMM). Você pode criar as seguintes funções de usuário: Administrador delegado, Administrador de Read-Only, Administrador de máquina virtual e Usuário Self-Service. Existe apenas uma função de Administrador. Não é possível criar outra função de Administrador ou excluir a existente.
Se você for membro de uma função de usuário Administrador Delegado, poderá criar uma função de usuário. No entanto, o escopo da nova função de usuário deve ser um subconjunto do escopo de sua função de usuário pai.
Depois de criar uma função de usuário, você pode usar o cmdlet Set-SCUserRole para renomear a função de usuário, adicionar ou remover membros e adicionar ou modificar o escopo de objetos que os membros da função podem gerenciar. Para uma função de usuário Self-Service, você pode especificar quais ações os membros de uma função de usuário Self-Service podem executar em suas máquinas virtuais e pode definir uma cota que limite o número de máquinas virtuais que os usuários de autoatendimento podem criar. Embora não seja possível criar ou remover a função Administrador ou limitar seu escopo, você pode usar 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 usuário, digite Get-Help Set-SCUserRole.
Exemplos
Exemplo 1: Criar uma função de usuário Administrador Delegado
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Este comando cria uma função de usuário de administrador delegado chamada ContosoDelegatedAdmin, fornece a descrição Administradores Delegados para o domínio Contoso.com e usa o parâmetro UserRoleProfile para designar o tipo de função de usuário como Administrador Delegado.
Exemplo 2: Criar uma função de usuário de autoatendimento
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Este comando cria uma nova função de usuário chamada ContosoSelfServiceUsers, usa o parâmetro UserRoleProfile para designar o novo tipo de função de usuário como Self-Service usuário e armazena o novo objeto de função de usuário 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 usuário de administrador de máquina virtual chamada VirtualMachineAdmin, fornece a descrição 'Administrador de máquina virtual para contoso.com domínio' e usa o parâmetro UserRoleProfile para designar o tipo de função de usuário como VMAdmin.
Parâmetros
-Description
Especifica uma descrição para a função de usuário.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ID
Especifica a ID exclusiva para a nova função de usuário.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobGroup
Especifica um identificador para uma série de comandos que é executado como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobVariable
Especifica uma variável na qual o progresso do trabalho é controlado e armazenado.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Name
Especifica um nome para a nova função de usuário.
| Tipo: | String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Tipo: | UserRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ParentUserRole
Especifica uma função de usuário existente do VMM como o pai da nova função de usuário.
| Tipo: | UserRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UserRoleProfile
Especifica o tipo de perfil que é a base para a nova função de usuário. Os valores aceitáveis para este parâmetro são:
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- InquilinoAdmin
- VMAdmin
| Tipo: | Profile |
| Valores aceites: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VMMServer
Especifica o servidor VMM no qual esse cmdlet cria uma função de usuário.
| Tipo: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
Saídas
UserRole
Este cmdlet retorna um objeto UserRole.