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