Set-MailPublicFolder

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2011-01-26

Use o cmdlet Set-MailPublicFolder para configurar as definições relacionadas a emails de pastas públicas habilitadas para email. Se deseja configurar definições básicas não relacionadas a mensagens, use o cmdlet Set-PublicFolder.

Sintaxe

Set-MailPublicFolder -Identity <MailPublicFolderIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-Contacts <RecipientIdParameter[]>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DeliverToMailboxAndForward <$true | $false>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ForwardingAddress <RecipientIdParameter>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PhoneticDisplayName <String>] [-PrimarySmtpAddress <SmtpAddress>] [-PublicFolderType <GeneralPurpose | Mapi | Nntp | NotSpecified>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-Server <ServerIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-MailPublicFolder [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-Contacts <RecipientIdParameter[]>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DeliverToMailboxAndForward <$true | $false>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ForwardingAddress <RecipientIdParameter>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailPublicFolder>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PhoneticDisplayName <String>] [-PrimarySmtpAddress <SmtpAddress>] [-PublicFolderType <GeneralPurpose | Mapi | Nntp | NotSpecified>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-Server <ServerIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

Para executar o cmdlet Set-MailPublicFolder, você deve usar uma conta à qual esteja delegada a seguinte função:

  • Função de Administrador de Pasta Pública do Exchange e grupo Administradores local no servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MailPublicFolderIdParameter

Utilize o parâmetro Identity para especificar a GUID ou o nome da pasta pública que representa uma pasta pública específica. Você pode também incluir o caminho utilizando o formato \TopLevelPublicFolder\PublicFolder.

Você pode omitir o rótulo do parâmetro Identity para que somente o nome da pasta pública ou a GUID seja fornecido.

AcceptMessagesOnlyFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Use o parâmetro AcceptMessagesOnlyFrom para especificar uma lista limitada de remetentes dos quais aceitar mensagens.

AcceptMessagesOnlyFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Use o parâmetro AcceptMessagesOnlyFromDLMembers para especificar membros da lista de distribuição que podem enviar mensagens para a pasta pública habilitada para email.

Alias

Opcional

System.String

Use o parâmetro Alias para especificar o alias (apelido de email) da pasta pública. Se não for especificado, o valor do parâmetro Alias será carimbado com o nome da pasta pública.

A cadeia de caracteres deve ser compatível com os requisitos do RFC 2821 para endereços SMTP da "parte local" válidos.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

Contacts

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro Contacts especifica os contatos para a pasta pública. Contatos são pessoas sobre quem você pode salvar vários tipos de informações, como endereços, números de telefone e URLs da página da Web.

CreateDTMFMap

Opcional

System.Boolean

Esse parâmetro determina a criação de um mapa de multifreqüência de tom dual (DTMF) para o usuário.

CustomAttribute1

Opcional

System.String

O parâmetro CustomAttribute1 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute10

Opcional

System.String

O parâmetro CustomAttribute10 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute11

Opcional

System.String

O parâmetro CustomAttribute11 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute12

Opcional

System.String

O parâmetro CustomAttribute12 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute13

Opcional

System.String

O parâmetro CustomAttribute13 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute14

Opcional

System.String

O parâmetro CustomAttribute14 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute15

Opcional

System.String

O parâmetro CustomAttribute15 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute2

Opcional

System.String

O parâmetro CustomAttribute2 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute3

Opcional

System.String

O parâmetro CustomAttribute3 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute4

Opcional

System.String

O parâmetro CustomAttribute4 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute5

Opcional

System.String

O parâmetro CustomAttribute5 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute6

Opcional

System.String

O parâmetro CustomAttribute6 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute7

Opcional

System.String

O parâmetro CustomAttribute7 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute8

Opcional

System.String

O parâmetro CustomAttribute8 pode ser qualquer valor de cadeia de caracteres.

CustomAttribute9

Opcional

System.String

O parâmetro CustomAttribute9 pode ser qualquer valor de cadeia de caracteres.

DeliverToMailboxAndForward

Opcional

System.Boolean

O parâmetro DeliverToMailboxAndForward especifica se as mensagens de email serão enviadas para um endereço de encaminhamento.

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome para exibição do objeto Proxy de Pasta Pública.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

EmailAddresses

Opcional

Microsoft.Exchange.Data.ProxyAddressCollection

Use o parâmetro EmailAddresses para especificar endereços de proxy (por exemplo, usuário@contoso.com).

EmailAddressPolicyEnabled

Opcional

System.Boolean

Use o parâmetro EmailAddressPolicyEnabled para habilitar ou desabilitar uma diretiva de endereço de email aplicada à pasta.

ForwardingAddress

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Use o parâmetro ForwardingAddress para definir o endereço de encaminhamento da pasta.

GrantSendOnBehalfTo

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro GrantSendOnBehalfTo especifica o nome distinto de outras caixas de correio que podem enviar mensagens em nome desta pasta.

HiddenFromAddressListsEnabled

Opcional

System.Boolean

O parâmetro HiddenFromAddressListsEnabled especifica se a caixa de correio é visualizável a partir das listas de endereços.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estejam atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar apenas o nome distinto do parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.MailPublicFolder

O parâmetro Instance especifica uma instância de um objeto do Active Directory que é canalizada e consumida por este comando.

MaxReceiveSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxReceiveSize especifica o tamanho máximo de mensagens de email que podem ser recebidas pela pasta. Os valores válidos estão entre 1 KB (kilobyte) a 2.097.151 KB. Se um valor não for especificado para este parâmetro, nenhum limite de tamanho será imposto.

MaxSendSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxSendSize especifica o tamanho máximo de mensagens de email que podem ser enviadas. Os valores válidos estão entre 1 KB a 2.097.151 KB. Se um valor não for especificado para este parâmetro, nenhum limite de tamanho será imposto.

Name

Opcional

System.String

O parâmetro Name especifica o nome da pasta pública.

PhoneticDisplayName

Opcional

System.String

O parâmetro PhoneticDisplayName especifica uma pronúncia fonética do parâmetro DisplayName.

O tamanho máximo desse valor de parâmetro é 255 caracteres. Para obter mais informações sobre o parâmetro PhoneticDisplayName e reconhecimento de fala, consulte Compreendendo pesquisas de diretório de Reconhecimento Automático de Fala.

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

Use o parâmetro PrimarySmtpAddress para especificar o endereço SMTP principal para a pasta.

PublicFolderType

Opcional

Microsoft.Exchange.Data.Directory.Recipient.PublicFolderType

O parâmetro PublicFolderType especifica qual dos quatro tipos a seguir é atribuído à pasta pública:

  • GeneralPurpose

  • MAPI

  • NNTP

  • NotSpecified

RejectMessagesFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFrom especifica os destinatários dos quais rejeitar mensagens.

RejectMessagesFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFromDLMembers especifica os membros da lista de distribuição dos quais rejeitar mensagens.

RequireSenderAuthenticationEnabled

Opcional

System.Boolean

O parâmetro RequireSenderAuthenticationEnabled especifica se os remetentes devem ser autenticados.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica a identidade do servidor do qual executar a operação. Se um servidor não for especificado, o comando verificará se o servidor local é um servidor de Caixa de correio que está executando o com um armazenamento de pasta pública. Se for, a pasta será criada localmente. Se não for, o comando encontrará o servidor de Caixa de Correio do Exchange 2007 mais próximo (por custo do site) que tenha um armazenamento de pasta pública montado.

SimpleDisplayName

Opcional

System.String

O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto quando somente um conjunto limitado de caracteres for permitido. Esse conjunto limitado de caracteres consiste em caracteres ASCII de 26 a 126, inclusive.

UMDtmfMap

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Use o parâmetro UMDtmfMap para especificar se deseja criar um mapa de DTMF definido pelo usuário para o usuário habilitado para UM.

UseRusServer

Optional

System.String

Observação   Esse parâmetro está disponível somente no Exchange Server 2007 SP2.

O parâmetro UseRusServer instrui o comando a utilizar o servidor de Caixa de Correio especificado no serviço Lista de Endereços em execução, a fim de obter e então definir a caixa de correio e os atributos de usuário do Active Directory.

O serviço Lista de Endereços é um componente do serviço Assistente do Sistema do Exchange. O serviço Lista de Endereços cria e mantém valores de atributo específicos do Exchange no Active Directory. Você pode usar o serviço Lista de Endereços para atualizar objetos de destinatário em um domínio usando informações específicas, como associação na lista de endereços e endereços de email.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

WindowsEmailAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro WindowsEmailAddress especifica um endereço de email no formato E-mailAddress@contoso.com.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Este exemplo define o endereço SMTP principal da pasta pública habilitada para email MyPublicFolder@contoso.com como MyPublicFolder@fabrikam.com.

Set-MailPublicFolder -Identity MyPublicFolder@contoso.com -PrimarySmtpAddress MyPublicFolder@fabrikam.com