Set-MailboxFolderPermission

Módulo:
Exchange PowerShell

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 ambiente ou de outro.

Use o cmdlet Set-MailboxFolderPermission para modificar as permissões no nível da pasta para usuários em caixas de correio. Este cmdlet difere do cmdlet Add-MailboxFolderPermission porque modifica entradas de permissão existentes. Para definir as configurações de publicação ou compartilhamento de calendário para uma caixa de correio para que as informações do 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.

Sintaxe

Default (Default) 

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

Description

No 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 representante existente e você alterar suas permissões para Editor sem usar os parâmetros SendNotificationToUser ou SharingPermissionFlags, o usuário permanecerá um representante. Mas, se você usar o parâmetro SendNotificationToUser ($true ou $false), o parâmetro SharingPermissionFlags terá o valor padrão None, o que pode afetar o acesso delegado para usuários existentes. Por exemplo, você altera a permissão de um representante existente para Editor e usa SendNotificationToUser com o valor $true. O usuário não é mais um representante e tem apenas permissões de Editor para a pasta.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 de Ed para a pasta Marketing na caixa de correio de Ayla. Ed agora 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

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

Exemplo 3

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

No Exchange Online, esse exemplo remove o acesso a itens particulares para um representante existente.

Exemplo 4

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

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

Exemplo 5

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

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

Exemplo 6

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

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

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ê deseja modificar para o usuário na pasta da 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 na 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:

  • AvailabilityOnly: 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 representantes podem aceitar ou recusar reuniões selecionando manualmente a solicitação de reunião na caixa de correio. No Exchange Online, para enviar solicitações de reunião para representantes onde eles podem aceitar ou recusar reuniões, use também o parâmetro SharingPermissionFlags com o valor Delegate.

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. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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 , você pode usar qualquer valor que identifique exclusivamente a caixa de MailboxIDcorreio. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domínio\Nome de usuário
  • 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 um convite de compartilhamento deve ser enviado ao usuário quando você modifica suas permissões de calendário. A mensagem é um convite normal de compartilhamento de calendário que pode ser aceito pelo destinatário. Os valores válidos são:

  • $true: um convite para compartilhamento é enviado.
  • $false: Nenhum convite para compartilhamento é enviado. Esse valor é o 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:

  • AvailabilityOnly
  • Detalhes Limitados
  • 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 representante 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 as permissões de representante e atualiza a regra de mensagem de reunião para que o usuário pare de receber convites e respostas de reunião para a caixa de correio. Esse valor é o padrão quando você usa o parâmetro SendNotificationToUser sem especificar um valor para o parâmetro SharingPermissionFlags.
  • Representante: o usuário recebe um representante de calendário, o que inclui o recebimento de convites e respostas para reuniões. Se não houver outros representantes, esse valor criará a regra de mensagem da reunião. Se houver representantes existentes, o usuário será adicionado à regra de mensagem de reunião sem alterar como as mensagens de representante são enviadas.
  • CanViewPrivateItems: o usuário pode acessar itens particulares no calendário. Você deve usar esse valor com o valor Delegate.

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

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 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.

Para obter os melhores resultados, recomendamos o uso dos seguintes valores:

  • UPN: por exemplo, user@contoso.com (somente usuários).
  • Domain\SamAccountName: Por exemplo, contoso\user.

Caso contrário, você poderá usar qualquer valor que identifique exclusivamente o usuário 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 mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.