Set-MailboxFolderPermission

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Use o cmdlet Set-MailboxFolderPermission para modificar permissões no nível da pasta para usuários em caixas de correio. Esse cmdlet difere do cmdlet Add-MailboxFolderPermission em que modifica as entradas de permissão existentes. Para configurar configurações de publicação ou compartilhamento de calendário para uma caixa de correio para que as informações de calendário fiquem visíveis para usuários externos, use o cmdlet Set-MailboxCalendarFolder.

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

Syntax

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

Description

Em Exchange Online PowerShell, se você não usar os parâmetros SendNotificationToUser ou SharingPermissionFlags, não haverá alterações na funcionalidade do cmdlet. Por exemplo, se o usuário for um delegado existente e você alterar suas permissões para Editor sem usar os parâmetros SendNotificationToUser ou SharingPermissionFlags, o usuário continuará sendo um delegado. Mas, se você usar o parâmetro SendNotificationToUser ($true ou $false), o parâmetro SharingPermissionFlags terá o valor padrão None, que pode afetar o acesso de delegado para usuários existentes. Por exemplo, você altera a permissão de um delegado existente para Editor e usa SendNotificationToUser com o valor $true. O usuário não será mais um delegado e só terá permissões do Editor para a pasta.

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

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

Este exemplo substitui as permissões existentes do Ed para a pasta Marketing na caixa de correio da Ayla. Agora, o Ed recebe a função Proprietário na pasta.

Exemplo 2

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate -SendNotificationToUser $true

Em Exchange Online, este exemplo reenvia o convite de compartilhamento para um delegado existente sem alterar suas permissões efetivas (Ed já é um delegado com permissões do Editor para a caixa de correio da Ayla).

Exemplo 3

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

Em Exchange Online, este exemplo remove o acesso a itens privados para um delegado existente.

Exemplo 4

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags None

Em Exchange Online, este exemplo altera um delegado de calendário existente para Editor.

Exemplo 5

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor

Em Exchange Online, este exemplo altera as permissões de um usuário existente para Editor sem alterar o status de delegado atual.

Exemplo 6

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SendNotificationToUser $false

Em Exchange Online, este exemplo altera as permissões de um usuário existente para Editor e remove o status de delegado atual.

Parâmetros

-AccessRights

O parâmetro AccessRights especifica as permissões que você deseja modificar para o usuário na pasta caixa de correio. Os valores especificados substituem as permissões existentes para o usuário na pasta.

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 usuário não tem acesso para exibir ou interagir com a pasta ou seu conteúdo.
  • CreateItems: o usuário pode criar itens na pasta especificada.
  • CreateSubfolders: o usuário pode criar subpastas na pasta especificada.
  • DeleteAllItems: o usuário pode excluir todos os itens na pasta especificada.
  • DeleteOwnedItems: o usuário só pode excluir itens criados a partir da pasta especificada.
  • EditAllItems: o usuário pode editar todos os itens na pasta especificada.
  • EditOwnedItems: o usuário só pode editar itens criados na pasta especificada.
  • FolderContact: o usuário é o contato da pasta pública especificada.
  • FolderOwner: o usuário é o proprietário da pasta especificada. O usuário pode exibir a pasta, mover a pasta e criar subpastas. O usuário não pode ler, editar, excluir ou criar itens.
  • FolderVisible: o usuário pode exibir a pasta especificada, mas não pode ler ou editar itens dentro da pasta pública especificada.
  • ReadItems: o usuário pode ler itens dentro da 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
  • Colaborador: 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: exibir somente dados de disponibilidade
  • LimitedDetails: exibir dados de disponibilidade com assunto e local

Quando a função Editor é aplicada a pastas de calendário, os delegados podem aceitar ou recusar reuniões selecionando manualmente a solicitação de reunião na caixa de correio. Em Exchange Online, para enviar solicitações de reunião aos delegados em que possam aceitar ou recusar reuniões, use também o parâmetro SharingPermissionFlags com o valor Delegado.

Type:MailboxFolderAccessRight[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

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

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

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

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

Type:MailboxFolderIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SendNotificationToUser

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

O parâmetro SendNotificationToUser especifica se você deve enviar um convite de compartilhamento ao usuário ao modificar suas permissões de calendário. A mensagem será um convite normal de compartilhamento de calendário que pode ser aceito pelo destinatário. Os valores válidos são:

  • $true: um convite de compartilhamento é enviado.
  • $false: nenhum convite de compartilhamento é enviado. Esse é o valor padrão.

Esse parâmetro só se aplica a pastas de calendário e só pode ser usado com os seguintes valores de parâmetro AccessRights:

  • DisponibilidadeOnly
  • LimitedDetails
  • Revisor
  • Editor
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SharingPermissionFlags

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. Esse parâmetro só se aplica a pastas de calendário e só pode ser usado quando o valor do parâmetro AccessRights for Editor. Os valores válidos são:

  • Nenhum: remove permissões de delegado e atualiza a regra da mensagem de reunião para que o usuário pare de receber convites e respostas de reunião para a caixa de correio. Esse é o valor padrão quando você usa o parâmetro SendNotificationToUser sem especificar um valor para o parâmetro SharingPermissionFlags.
  • Delegado: o usuário é feito um delegado de calendário, que inclui o recebimento de convites e respostas da reunião. Se não houver outros delegados, esse valor criará a regra da mensagem de reunião. Se houver delegados existentes, o usuário será adicionado à regra da mensagem de reunião sem alterar a forma como as mensagens de delegado são enviadas.
  • CanViewPrivateItems: o usuário pode acessar itens privados no calendário. Você deve usar esse valor com o valor Delegado.

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

Type:MailboxFolderPermissionFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-User

O parâmetro User especifica a caixa de correio, o usuário de email ou o grupo de segurança habilitado para email (entidade de segurança) que recebe a permissão para a pasta caixa de correio. É possível usar qualquer valor que identifique o usuário ou grupo com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID
Type:MailboxFolderUserIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.