New-SCUserRole
Cria uma função de usuário para um grupo de usuários do 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 usuário para um grupo de usuários do VMM (Virtual Machine Manager). Você pode criar as seguintes funções de usuário: Administrador Delegado, Administrador 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 nem 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 assumir em suas máquinas virtuais e pode definir uma cota que limita 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"Esse 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"Esse 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"Esse comando cria uma função de usuário 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Especifica a ID exclusiva para a nova função de usuário.
| 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 são executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica uma variável na qual 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 usuário.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ParentUserRole
Especifica uma função de usuário do VMM existente como o pai da nova função de usuário.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell 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 usuário. Os valores aceitáveis para esse parâmetro são:
- 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 o servidor VMM no qual esse cmdlet cria uma função de usuário.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
UserRole
Este cmdlet retorna um objeto UserRole .