Compartilhar via

Add-MailboxFolderPermission

Módulo:
Exchange PowerShell

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.

Use o cmdlet Add-MailboxFolderPermission para adicionar as permissões no nível de pasta para usuários em caixas de correio.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Padrão) 

Add-MailboxFolderPermission
    [-Identity] <MailboxFolderIdParameter>
    -AccessRights <MailboxFolderAccessRight[]>
    -User <MailboxFolderUserIdParameter>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-SendNotificationToUser <Boolean>]
    [-SharingPermissionFlags <MailboxFolderPermissionFlags>]
    [-WhatIf]
    [<CommonParameters>]

Description

Para modificar as permissões que são atribuídas ao usuário em uma pasta da caixa de correio, use o cmdlet Set-MailboxFolderPermission. Para remover todas as permissões que são atribuídas a um usuário em uma pasta da caixa de correio, use o cmdlet Remove-MailboxFolderPermission.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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

Add-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner

Este exemplo concede a função Proprietário à Eduardo na pasta Marketing da caixa de correio de Lara.

Exemplo 2

Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User julia@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate

No Exchange Online, este exemplo adiciona Júlia como delegada de calendário à caixa de correio do Ayla, mas sem acesso a itens privados.

Exemplo 3

Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User laura@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate,CanViewPrivateItems

No Exchange Online, este exemplo adiciona a Laura como delegada de calendário à caixa de correio da Ayla com acesso a itens privados.

Parâmetros

-AccessRights

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro AccessRights especifica as permissões que você quer adicionar para o usuário na pasta da caixa de correio.

Você pode especificar permissões de pastas individuais ou funções, que são combinações de permissões. Você pode especificar várias permissões e funções separadas por vírgulas.

As seguintes permissões individuais estão disponíveis:

  • Nenhum: o utilizador não tem acesso para ver ou interagir com a pasta ou o respetivo conteúdo.
  • CreateItems: o utilizador pode criar itens na pasta especificada.
  • CreateSubfolders: o utilizador pode criar subpastas na pasta especificada.
  • DeleteAllItems: o utilizador pode eliminar todos os itens na pasta especificada.
  • DeleteOwnedItems: o utilizador só pode eliminar itens que criou a partir da pasta especificada.
  • EditAllItems: o utilizador pode editar todos os itens na pasta especificada.
  • EditOwnedItems: o utilizador só pode editar itens que criou na pasta especificada.
  • FolderContact: o utilizador é o contacto da pasta pública especificada.
  • FolderOwner: o utilizador é o proprietário da pasta especificada. O utilizador pode ver a pasta, mover a pasta e criar subpastas. O utilizador não consegue ler itens, editar itens, eliminar itens ou criar itens.
  • PastaVisível: o utilizador pode ver a pasta especificada, mas não consegue ler ou editar itens na pasta pública especificada.
  • ReadItems: o utilizador pode ler itens na pasta especificada.

As funções disponíveis, além das permissões que elas atribuem, são descritas na lista a seguir:

  • Autor: CreateItems, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • Contribuidor: CreateItems, FolderVisible
  • Editor: CreateItems, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • NonEditingAuthor: CreateItems, DeleteOwnedItems, FolderVisible, ReadItems
  • Proprietário: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible, ReadItems
  • PublishingAuthor: CreateItems, CreateSubfolders, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • PublishingEditor: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • Revisor: FolderVisible, ReadItems

As seguintes funções se aplicam especificamente a pastas de calendário:

  • DisponibilidadeOnly: Ver apenas dados de disponibilidade
  • LimitedDetails: ver dados de disponibilidade com o assunto e a localização

Quando a função Editor é aplicada a pastas de calendário, os delegados podem aceitar ou recusar reuniões ao selecionar manualmente o pedido de reunião na caixa de correio. No Exchange Online, para enviar pedidos de reunião aos delegados onde possam aceitar ou recusar reuniões, utilize também o parâmetro SharingPermissionFlags com o valor Delegado.

Propriedades do parâmetro

Tipo:

MailboxFolderAccessRight[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Identity especifica a caixa de correio e a pasta de destino. A sintaxe é MailboxID:\ParentFolder[\SubFolder].

Para o valor de MailboxID, pode utilizar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domínio\Nome de Utilizador
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Os valores de exemplo para este parâmetro são john@contoso.com:\Calendar ou John:\Inbox\Reports.

Propriedades do parâmetro

Tipo:MailboxFolderIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SendNotificationToUser

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro SendNotificationToUser especifica se pretende enviar um convite de partilha ao utilizador quando adiciona permissões de calendário para o mesmo. A mensagem é um convite de partilha de calendário normal que pode ser aceite pelo destinatário. Os valores válidos são:

  • $true: é enviado um convite de partilha.
  • $false: não é enviado nenhum convite de partilha. Este valor é a predefinição.

Este parâmetro aplica-se apenas a pastas de calendário e só pode ser utilizado com os seguintes valores de parâmetro AccessRights:

  • DisponibilidadeOnly
  • LimitedDetails
  • Revisor
  • Editor

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SharingPermissionFlags

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

O parâmetro SharingPermissionFlags atribui permissões de delegado de calendário. Este parâmetro só se aplica a pastas de calendário e só pode ser utilizado quando o valor do parâmetro AccessRights é Editor. Os valores válidos são:

  • Nenhum: não tem efeito. Este valor é a predefinição.
  • Delegado: o utilizador é tornado delegado de calendário, o que inclui a receção de convites e respostas de reunião. Se não existirem outros delegados, este valor cria a regra de mensagem de reunião. Se existirem delegados, o utilizador é adicionado à regra da mensagem de reunião sem alterar a forma como as mensagens delegadas são enviadas.
  • CanViewPrivateItems: o utilizador pode aceder a itens privados no calendário. Tem de utilizar este valor com o valor Delegado.

Vários valores, separados por vírgulas, podem ser especificados.

Nota: não pode configurar a definição Entregar pedidos de reunião endereçados a mim e respostas a pedidos de reunião em que sou o organizador da definição do Outlook no PowerShell. No entanto, pode configurar a definição através dos Serviços Web exchange (EWS). Para obter mais informações, consulte MeetingRequestsDeliveryScope Enum.

Propriedades do parâmetro

Tipo:MailboxFolderPermissionFlags
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-User

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro User especifica quem recebeu permissão para a pasta da caixa de correio. Os valores válidos são entidades de segurança habilitadas para email (contas ou grupos habilitados para email que têm identificadores de segurança ou SIDs que podem ter permissões atribuídas a eles). Por exemplo:

  • Caixas de correio de usuário
  • Usuários de e-mail
  • Grupos de segurança com capacidade de correio (incluindo grupos de segurança aninhados com capacidade de correio)

Para obter os melhores resultados, recomendamos que utilize os seguintes valores:

  • UPN: por exemplo, user@contoso.com (apenas utilizadores).
  • Domain\SamAccountName: por exemplo, contoso\user.

Caso contrário, pode utilizar qualquer valor que identifique exclusivamente o utilizador ou grupo. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Propriedades do parâmetro

Tipo:MailboxFolderUserIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

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.