New-ManagementRoleAssignment

Syntax

New-ManagementRoleAssignment
   [[-Name] <String>]
   -Role <RoleIdParameter>
   -App <ServicePrincipalIdParameter>
   [-CustomResourceScope <ManagementScopeIdParameter>]
   [-Confirm]
   [-Delegating]
   [-Force]
   [-RecipientAdministrativeUnitScope <AdministrativeUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

New-ManagementRoleAssignment
   [[-Name] <String>]
   -Computer <ComputerIdParameter>
   -Role <RoleIdParameter>
   [-Confirm]
   [-CustomConfigWriteScope <ManagementScopeIdParameter>]
   [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
   [-DomainController <Fqdn>]
   [-ExclusiveConfigWriteScope <ManagementScopeIdParameter>]
   [-ExclusiveRecipientWriteScope <ManagementScopeIdParameter>]
   [-Force]
   [-RecipientAdministrativeUnitScope <AdministrativeUnitIdParameter>]
   [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
   [-RecipientRelativeWriteScope <RecipientWriteScopeType>]
   [-UnScopedTopLevel]
   [-WhatIf]
   [<CommonParameters>]

New-ManagementRoleAssignment
   [[-Name] <String>]
   -Policy <MailboxPolicyIdParameter>
   -Role <RoleIdParameter>
   [-Confirm]
   [-CustomConfigWriteScope <ManagementScopeIdParameter>]
   [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
   [-DomainController <Fqdn>]
   [-ExclusiveConfigWriteScope <ManagementScopeIdParameter>]
   [-ExclusiveRecipientWriteScope <ManagementScopeIdParameter>]
   [-Force]
   [-RecipientAdministrativeUnitScope <AdministrativeUnitIdParameter>]
   [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
   [-RecipientRelativeWriteScope <RecipientWriteScopeType>]
   [-UnScopedTopLevel]
   [-WhatIf]
   [<CommonParameters>]

New-ManagementRoleAssignment
   [[-Name] <String>]
   -Role <RoleIdParameter>
   -SecurityGroup <SecurityGroupIdParameter>
   [-Delegating]
   [-Confirm]
   [-CustomConfigWriteScope <ManagementScopeIdParameter>]
   [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
   [-DomainController <Fqdn>]
   [-ExclusiveConfigWriteScope <ManagementScopeIdParameter>]
   [-ExclusiveRecipientWriteScope <ManagementScopeIdParameter>]
   [-Force]
   [-RecipientAdministrativeUnitScope <AdministrativeUnitIdParameter>]
   [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
   [-RecipientRelativeWriteScope <RecipientWriteScopeType>]
   [-UnScopedTopLevel]
   [-WhatIf]
   [<CommonParameters>]

New-ManagementRoleAssignment
   [[-Name] <String>]
   -Role <RoleIdParameter>
   -User <UserIdParameter>
   [-Delegating]
   [-Confirm]
   [-CustomConfigWriteScope <ManagementScopeIdParameter>]
   [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
   [-DomainController <Fqdn>]
   [-ExclusiveConfigWriteScope <ManagementScopeIdParameter>]
   [-ExclusiveRecipientWriteScope <ManagementScopeIdParameter>]
   [-Force]
   [-RecipientAdministrativeUnitScope <AdministrativeUnitIdParameter>]
   [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
   [-RecipientRelativeWriteScope <RecipientWriteScopeType>]
   [-UnScopedTopLevel]
   [-WhatIf]
   [<CommonParameters>]

Description

Ao adicionar uma nova atribuição de função, é possível especificar uma função integrada ou personalizada criada usando o cmdlet New-ManagementRole e especificar uma OU (unidade organizacional) ou escopo de gerenciamento predefinido ou personalizado para restringir a atribuição.

É possível criar escopos de gerenciamento personalizados usando o cmdlet New-ManagementScope e exibir uma lista de escopos existentes usando o cmdlet Get-ManagementScope. Se preferir não especificar uma OU, um escopo predefinido ou personalizado, o escopo de gravação implícito da função se aplicará à atribuição de função.

Para obter mais informações sobre atribuições de função de gerenciamento, consulte Noções básicas sobre as atribuições de função de gerenciamento.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

New-ManagementRoleAssignment -Role "Mail Recipients" -SecurityGroup "Tier 2 Help Desk"

Este exemplo atribui a função Mail Recipients ao grupo de funções Tier 2 Help Desk.

Exemplo 2

Get-ManagementRole "MyVoiceMail" | Format-Table Name, IsEndUserRole

New-ManagementRoleAssignment -Role "MyVoiceMail" -Policy "Sales end-users"

Este exemplo atribui a função MyVoiceMail à diretiva de atribuição de função de "usuários finais Sales". Primeiro, a propriedade IsEndUserRole na função MyVoiceMail é verificada para ter certeza de que está definida como $true, indicando que é uma função de usuário final.

Depois da confirmação de que a função é uma função de usuário final, ela é atribuída à diretiva de atribuição de função de "usuários finais Sales".

Exemplo 3

New-ManagementRoleAssignment -Role "Eng Help Desk" -SecurityGroup "Eng HD Personnel" -RecipientOrganizationalUnitScope contoso.com/Engineering/Users

Este exemplo atribui a função Eng Help Desk ao grupo de funções Eng HD Personnel. A atribuição restringe o escopo de gravação do destinatário da função na OU contoso.com/Engineering/Users. Os usuários que forem membros do grupo de funções Eng HD Personnel só poderão criar, modificar ou remover objetos contidos na OU.

Exemplo 4

New-ManagementRoleAssignment -Role "Distribution Groups" -SecurityGroup "North America Exec Assistants" -CustomRecipientWriteScope "North America Recipients"

Este exemplo atribui a função Distribution Groups ao grupo de funções North America Exec Assistants. A atribuição restringe o escopo de gravação do destinatário da função ao escopo especificado no escopo de gerenciamento do destinatário personalizado North America Recipients. Os usuários que forem membros do grupo de funções North America Exec Assistants só poderão criar, modificar ou remover objetos de grupos de distribuição que correspondam ao escopo de gerenciamento do destinatário personalizado especificado.

Exemplo 5

New-ManagementRoleAssignment -Name "Exchange Servers_John" -Role "Exchange Servers" -User John -CustomConfigWriteScope "Sydney Servers"

Este exemplo atribui a função Exchange Servers a John. Como John deve gerenciar apenas os servidores que executam o Exchange localizados em Sydney, a atribuição de função restringe o escopo de gravação de configuração da função ao escopo especificado no grupo de funções de configuração personalizado do Sydney Servers. John só poderá gerenciar servidores que correspondam ao escopo de gerenciamento de configuração personalizada especificado.

Exemplo 6

New-ManagementRoleAssignment -Name "Excl-Mail Recipients_Executive Administrators" -Role "Mail Recipients" -SecurityGroup "Executive Administrators" -ExclusiveRecipientWriteScope "Exclusive-Executive Recipients"

Este exemplo atribui a função Mail Recipients ao grupo de funções Executive Administrators. A atribuição restringe o escopo de gravação do destinatário da função ao escopo especificado no escopo de gerenciamento do destinatário exclusivo Exclusive-Executive Recipients. Como o escopo Exclusive-Executive Recipients é um escopo exclusivo, apenas os usuários do Executive Administrators poderão gerenciar os destinatários executivos que correspondem ao escopo do destinatário exclusivo. Nenhum outro usuário poderá modificar os destinatários executivos, a não ser que também tenham recebido uma atribuição que use um escopo exclusivo que corresponda aos mesmos usuários.

Exemplo 7

New-ManagementRoleAssignment -Name "Mail Recipients_Contoso Seattle" -Role "Mail Recipients" -SecurityGroup "Contoso Sub - Seattle" -CustomConfigWriteScope "Contoso Databases" -RecipientOrganizationalUnitScope adatum.com/Contoso/Seattle/Users

Este exemplo atribui a função Mail Recipients ao grupo de funções Contoso Sub - Seattle. Os administradores neste grupo de função somente devem ser permitidos para criar e gerenciar os destinatários de email nos bancos de dados específicos que foram alocados para uso pela subsidiária Contoso, A. Datum Corporation (adatum.com). Além disso, este grupo de administradores somente deve ter permissão de gerenciar os empregados da Contoso que estão localizados no escritório em Seattle. Isso é feito criando uma atribuição de função com um escopo de banco de dados, para limitar o gerenciamento de destinatários de email apenas aos bancos de dados no escopo do banco de dados e a um escopo de OU do destinatário, para limitar o acesso apenas aos objetos destinatários dentro da OU contoso seattle.

Parâmetros

-App

-Computer

-Confirm

-CustomConfigWriteScope

-CustomRecipientWriteScope

-CustomResourceScope

-Delegating

-DomainController

-ExclusiveConfigWriteScope

-ExclusiveRecipientWriteScope

-Force

-Name

-Policy

-RecipientAdministrativeUnitScope

-RecipientOrganizationalUnitScope

-RecipientRelativeWriteScope

-Role

-SecurityGroup

-UnScopedTopLevel

-User

-WhatIf

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.