Compartilhar via

Set-Mailbox

  • Artigo

 

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-Mailbox para modificar as configurações de uma caixa de correio existente. Você deve usar este cmdlet para uma caixa de correio de cada vez. Para realizar um gerenciamento em massa, você pode canalizar o resultado de vários cmdlets Get (por exemplo, os cmdlets Get-Mailbox ou Get-User) e configurar várias caixas de correio em um comando de uma única linha. Você também pode usar o cmdlet Set-Mailbox em scripts.

Sintaxe

set-Mailbox -Identity <MailboxIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-AntispamBypassEnabled <$true | $false>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-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>] [-DowngradeHighPriorityMessagesEnabled <$true | $false>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-EndDateForRetentionHold <Nullable>] [-Extensions <MultiValuedProperty>] [-ExternalOofOptions <InternalOnly | External>] [-ForwardingAddress <RecipientIdParameter>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-IssueWarningQuota <Unlimited>] [-Languages <MultiValuedProperty>] [-LinkedCredential <PSCredential>] [-LinkedDomainController <String>] [-LinkedMasterAccount <UserIdParameter>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-MaxBlockedSenders <Nullable>] [-MaxReceiveSize <Unlimited>] [-MaxSafeSenders <Nullable>] [-MaxSendSize <Unlimited>] [-Name <String>] [-Office <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RemoveManagedFolderAndPolicy <SwitchParameter>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-ResourceCapacity <Nullable>] [-ResourceCustom <MultiValuedProperty>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-RetentionHoldEnabled <$true | $false>] [-RulesQuota <ByteQuantifiedSize>] [-SamAccountName <String>] [-SCLDeleteEnabled <Nullable>] [-SCLDeleteThreshold <Nullable>] [-SCLJunkEnabled <Nullable>] [-SCLJunkThreshold <Nullable>] [-SCLQuarantineEnabled <Nullable>] [-SCLQuarantineThreshold <Nullable>] [-SCLRejectEnabled <Nullable>] [-SCLRejectThreshold <Nullable>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-StartDateForRetentionHold <Nullable>] [-Type <Regular | Room | Equipment | Shared>] [-UMDtmfMap <MultiValuedProperty>] [-UseDatabaseQuotaDefaults <Nullable>] [-UseDatabaseRetentionDefaults <$true | $false>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-Mailbox [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-AntispamBypassEnabled <$true | $false>] [-ApplyMandatoryProperties <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-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>] [-DowngradeHighPriorityMessagesEnabled <$true | $false>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-EndDateForRetentionHold <Nullable>] [-Extensions <MultiValuedProperty>] [-ExternalOofOptions <InternalOnly | External>] [-ForwardingAddress <RecipientIdParameter>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <Mailbox>] [-IssueWarningQuota <Unlimited>] [-Languages <MultiValuedProperty>] [-LinkedCredential <PSCredential>] [-LinkedDomainController <String>] [-LinkedMasterAccount <UserIdParameter>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-MaxBlockedSenders <Nullable>] [-MaxReceiveSize <Unlimited>] [-MaxSafeSenders <Nullable>] [-MaxSendSize <Unlimited>] [-Name <String>] [-Office <String>] [-OfflineAddressBook <OfflineAddressBookIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-ProhibitSendQuota <Unlimited>] [-ProhibitSendReceiveQuota <Unlimited>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RemoveManagedFolderAndPolicy <SwitchParameter>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-ResourceCapacity <Nullable>] [-ResourceCustom <MultiValuedProperty>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-RetainDeletedItemsUntilBackup <$true | $false>] [-RetentionHoldEnabled <$true | $false>] [-RulesQuota <ByteQuantifiedSize>] [-SamAccountName <String>] [-SCLDeleteEnabled <Nullable>] [-SCLDeleteThreshold <Nullable>] [-SCLJunkEnabled <Nullable>] [-SCLJunkThreshold <Nullable>] [-SCLQuarantineEnabled <Nullable>] [-SCLQuarantineThreshold <Nullable>] [-SCLRejectEnabled <Nullable>] [-SCLRejectThreshold <Nullable>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-StartDateForRetentionHold <Nullable>] [-Type <Regular | Room | Equipment | Shared>] [-UMDtmfMap <MultiValuedProperty>] [-UseDatabaseQuotaDefaults <Nullable>] [-UseDatabaseRetentionDefaults <$true | $false>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

Para executar o cmdlet Set-Mailbox, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador de Destinatários do Exchange

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

O parâmetro Identity identifica a caixa de correio. É possível usar os seguintes valores:

  • GUID

  • ADObjectID

  • Nome diferenciado (DN)

  • Domínio\Conta

  • Nome de usuário principal (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

AcceptMessagesOnlyFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFrom especifica os usuários da caixa de correio, os usuários de email e contatos de email que podem enviar as mensagens de email para essa caixa de correio. Você pode também especificar o Exchange como um destinatário válido para esse parâmetro. Se você configurar uma caixa de correio para aceitar mensagens apenas do destinatário do Exchange, ela receberá apenas as mensagens geradas pelo sistema.

O parâmetro AcceptMessagesOnlyFrom pode obter qualquer um dos seguintes valores para os remetentes válidos:

  • Nome diferenciado (DN)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • Alias

  • DN do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco. Este valor padrão permite que a caixa de correio aceite mensagens de todos os remetentes.

AcceptMessagesOnlyFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFromDLMembers especifica os grupos de distribuição cujos membros têm permissão para enviar mensagens de email para essa caixa de correio. Você pode usar qualquer um dos seguintes valores para os grupos de distribuição permitidos:

  • Nome diferenciado (DN)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco. Este valor padrão permite que a caixa de correio aceite mensagens de todos os remetentes.

Alias

Opcional

System.String

O parâmetro Alias especifica o alias (apelido de email) do usuário. O alias pode ser uma combinação de caracteres separados por um ponto sem espaços. Não use caracteres especiais no alias.

AntispamBypassEnabled

Opcional

System.Boolean

O parâmetro AntispamBypassEnabled especifica se deve-se ignorar o processamento anti-spam nesta caixa de correio. Os dois valores possíveis para esse parâmetro são $true ou $false.

ApplyMandatoryProperties

Opcional

System.Management.Automation.SwitchParameter

Não há suporte para a criação de uma caixa de correio do Exchange 2007 através de extensões do Exchange 2003 para o console de Usuários e Computadores do Active Directory. Se uma caixa de correio do Exchange 2007 for criada com essa ferramenta, ela será identificada como caixa de correio herdada, mesmo que resida em um servidor Exchange 2007. Use o parâmetro ApplyMandatoryProperties para modificar as propriedades obrigatórias de uma caixa de correio neste estado para corrigir o problema e remover a marca legacyMailbox da caixa de correio.

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.

CreateDTMFMap

Opcional

System.Boolean

Esse parâmetro especifica 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 especifica o valor para o atributo de caixa de correio CustomAttribute1.

CustomAttribute10

Opcional

System.String

O parâmetro CustomAttribute10 especifica o valor para o atributo de caixa de correio CustomAttribute10.

CustomAttribute11

Opcional

System.String

O parâmetro CustomAttribute11 especifica o valor para o atributo de caixa de correio CustomAttribute11.

CustomAttribute12

Opcional

System.String

O parâmetro CustomAttribute12 especifica o valor para o atributo de caixa de correio CustomAttribute12.

CustomAttribute13

Opcional

System.String

O parâmetro CustomAttribute13 especifica o valor para o atributo de caixa de correio CustomAttribute13.

CustomAttribute14

Opcional

System.String

O parâmetro CustomAttribute14 especifica o valor para o atributo de caixa de correio CustomAttribute14.

CustomAttribute15

Opcional

System.String

O parâmetro CustomAttribute15 especifica o valor para o atributo de caixa de correio CustomAttribute15.

CustomAttribute2

Opcional

System.String

O parâmetro CustomAttribute2 especifica o valor para o atributo de caixa de correio CustomAttribute2.

CustomAttribute3

Opcional

System.String

O parâmetro CustomAttribute3 especifica o valor para o atributo de caixa de correio CustomAttribute3.

CustomAttribute4

Opcional

System.String

O parâmetro CustomAttribute4 especifica o valor para o atributo de caixa de correio CustomAttribute4.

CustomAttribute5

Opcional

System.String

O parâmetro CustomAttribute5 especifica o valor para o atributo de caixa de correio CustomAttribute5.

CustomAttribute6

Opcional

System.String

O parâmetro CustomAttribute6 especifica o valor para o atributo de caixa de correio CustomAttribute6.

CustomAttribute7

Opcional

System.String

O parâmetro CustomAttribute7 especifica o valor para o atributo de caixa de correio CustomAttribute7.

CustomAttribute8

Opcional

System.String

O parâmetro CustomAttribute8 especifica o valor para o atributo de caixa de correio CustomAttribute8.

CustomAttribute9

Opcional

System.String

O parâmetro CustomAttribute9 especifica o valor para o atributo de caixa de correio CustomAttribute9.

DeliverToMailboxAndForward

Opcional

System.Boolean

O parâmetro DeliverToMailboxAndForward especifica se as mensagens enviadas para esta caixa de correio serão encaminhadas para outro endereço.

Se DeliverToMailboxAndForward for definido como $true, as mensagens serão entregues à caixa de correio e ao endereço de encaminhamento.

Se definido como $false, as mensagens serão entregues somente ao endereço de encaminhamento.

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome para exibição da conta do usuário associado a esta caixa de correio. O nome para exibição é usado pelo Microsoft Outlook.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

O parâmetro DomainController especifica o controlador de domínio a ser usado para gravar alterações no Active Directory. Use o nome de domínio totalmente qualificado (FQDN) do controlador de domínio a ser usado.

DowngradeHighPriorityMessagesEnabled

Opcional

System.Boolean

O parâmetro DowngradeHighPriorityMessagesEnabled impede que a caixa de correio envie as mensagens de alta prioridade para um sistema de correio X.400. Se esse parâmetro for definido como $true e a caixa de correio enviar uma mensagem de alta prioridade destinada a um sistema de email X.400, a prioridade da mensagem será alterada para normal.

EmailAddresses

Opcional

Microsoft.Exchange.Data.ProxyAddressCollection

O parâmetro EmailAddresses especifica todos os endereços de proxy da caixa de correio. Ele inclui o endereço SMTP (Simple Mail Transfer Protocol) principal como um dos endereços de proxy.

Se você usar esse parâmetro, não poderá usar o parâmetro PrimarySMTPAddress.

Importante

O Exchange 2007 não valida endereços personalizados quanto à formatação correta. Você deve verificar se o endereço personalizado especificado é compatível com os requisitos de formatação desse tipo de endereço. Como os endereços X.400 são considerados personalizados no Exchange 2007, eles também não serão validados. Portanto, você deve fornecer a sintaxe correta ao especificar um endereço X.400.

EmailAddressPolicyEnabled

Opcional

System.Boolean

O parâmetro EmailAddressPolicyEnabled especifica se a diretiva de endereço de email dessa caixa de correio está habilitada. Os dois valores possíveis para esse parâmetro são $true ou $false.

EndDateForRetentionHold

Opcional

System.Nullable

O parâmetro EndDateForRetentionHold especifica a data de término para retenção de gerenciamento de registros de mensagens (MRM). Para usar este parâmetro, é necessário que o parâmetro RetentionHoldEnabled seja definido como $true.

Extensions

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica um ou mais números de ramal para o usuário. Quando o parâmetro estiver definido, todos os números de ramal dentro do plano de discagem devem ser exclusivos.

ExternalOofOptions

Opcional

Microsoft.Exchange.Data.Directory.Recipient.ExternalOofOptions

O parâmetro ExternalOofOptions especifica a opção de envio de uma mensagem de Ausência Temporária para remetentes externos. É possível usar os seguintes valores:

  • Externo

  • InternalOnly

ForwardingAddress

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro ForwardingAddress especifica um endereço de encaminhamento. Se DeliverToMailboxAndForward for definido como $true, as mensagens que forem enviadas para esta caixa de correio serão encaminhadas para o endereço especificado.

GrantSendOnBehalfTo

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro GrantSendOnBehalfTo especifica o DN (nome diferenciado) de outras caixas de correio que podem enviar mensagens em nome desta caixa de correio.

HiddenFromAddressListsEnabled

Opcional

System.Boolean

O parâmetro HiddenFromAddressListsEnabled especifica se esta caixa de correio é ocultada de outras listas de endereços. Os dois valores possíveis para esse parâmetro são $true ou $false.

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 estão 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 o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.Mailbox

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

IssueWarningQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro IssueWarningQuota especifica o tamanho da caixa de correio na qual uma mensagem de aviso é enviada ao usuário.

Você deve especificar um inteiro ou "ilimitado."

Se você definir este atributo em uma caixa de correio, essa definição da caixa de correio substituirá o valor que está definido neste atributo no banco de dados da caixa de correio.

Languages

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro Languages especifica as preferências de idioma desta caixa de correio, em ordem de preferência. Vários componentes do Exchange exibirão informações para um usuário de caixa de correio no idioma de preferência, se esse idioma for aceito. Alguns desses componentes contêm mensagens de cota, notificações de falha na entrega (NDRs), interface do usuário do Microsoft Outlook Web Access e prompts de voz de Unificação de Mensagens (UM).

LinkedCredential

Opcional

System.Management.Automation.PSCredential

O parâmetro LinkedCredential especifica credenciais para uso do acesso ao controlador de domínio especificado pelo parâmetro LinkedDomainController.

LinkedDomainController

Opcional

System.String

O parâmetro LinkedDomainController especifica o controlador de domínio da floresta em que a conta do usuário reside, se essa caixa de correio for uma caixa de correio vinculada. O controlador de domínio da floresta em que a conta do usuário reside é utilizado para fornecer informações de segurança sobre a conta especificada pelo parâmetro LinkedMasterAccount.

LinkedMasterAccount

Opcional

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

O parâmetro LinkedMasterAccount especifica a conta principal da floresta em que a conta do usuário reside, se essa caixa de correio for uma caixa de correio vinculada. A conta principal é a conta à qual a caixa de correio está vinculada. A conta principal concederá acesso à caixa de correio. Você pode usar um dos seguintes valores:

  • GUID

  • Nome diferenciado (DN)

  • Domínio\Conta

  • Nome de usuário principal (UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

ManagedFolderMailboxPolicy

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

O parâmetro ManagedFolderMailboxPolicy especifica uma diretiva de caixa de correio de pasta gerenciada que controla o gerenciamento de registros de mensagens (MRM) da caixa de correio. Se o parâmetro for definido como $null, o Exchange removerá a diretiva de caixa de correio de pasta gerenciada da caixa de correio, mas todas as pastas gerenciadas da caixa de correio permanecerão.

ManagedFolderMailboxPolicyAllowed

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ManagedFolderMailboxPolicyAllowed ignora o aviso de que os recursos de MRM (gerenciamento de registros de mensagens) não são aceitos para clientes de email que estejam executando versões do Outlook anteriores ao Outlook 2007. Quando uma diretiva de caixa de correio de pasta gerenciada for atribuída a uma caixa de correio que utilize o parâmetro ManagedFolderMailboxPolicy, o aviso será exibido por padrão, a menos que ManagedFolderMailboxPolicyAllowed seja usado.

Dica

Embora clientes Outlook 2003 Service Pack 3 (SP3) tenham suporte, eles possuem funcionalidade de MRM limitada.

MaxBlockedSenders

Opcional

System.Nullable

Use o parâmetro MaxBlockedSenders para especificar o número máximo de remetentes que podem ser incluídos na lista de remetentes bloqueados. Remetentes bloqueados são remetentes que são considerados remetentes de lixo eletrônico pelo usuário da caixa de correio e são usados em regras de lixo eletrônico. Esse parâmetro só é validado quando as regras de lixo eletrônico são atualizadas com Outlook Web Access ou serviços da Web.

MaxReceiveSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxReceiveSize especifica o tamanho máximo de mensagens que esta caixa de correio pode receber. Você deve especificar um inteiro ou "ilimitado."

MaxSafeSenders

Opcional

System.Nullable

Use o parâmetro MaxSafeSenders para especificar o número máximo de remetentes que podem ser incluídos na lista de remetentes seguros. Remetentes seguros são remetentes em que o usuário da caixa de correio confia e são usados em regras de lixo eletrônico. Esse parâmetro só é validado quando as regras de lixo eletrônico são atualizadas com Outlook Web Access ou serviços da Web.

MaxSendSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxSendSize especifica o tamanho máximo de mensagens que esta caixa de correio pode enviar. Você deve especificar um inteiro ou "ilimitado."

Name

Opcional

System.String

O parâmetro Name especifica o atributo Name desta caixa de correio. O atributo Name é usado para o CN (nome comum) no Active Directory.

Office

Opcional

System.String

O parâmetro Office especifica o atributo Microsoft Office para a caixa de correio.

OfflineAddressBook

Opcional

Microsoft.Exchange.Configuration.Tasks.OfflineAddressBookIdParameter

O parâmetro OfflineAddressBook especifica o catálogo de endereços associado.

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro PrimarySmtpAddress especifica o endereço que os usuários externos verão ao receber uma mensagem desta caixa de correio.

Se usar esse parâmetro, você não poderá usar o parâmetro EmailAddresses, pois EmailAddresses inclui o endereço SMTP principal.

ProhibitSendQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ProhibitSendQuota especifica o tamanho da caixa de correio a partir do qual o usuário associado a esta caixa de correio não pode mais enviar mensagens.

Você deve especificar um inteiro ou "ilimitado."

Se você definir este atributo em uma caixa de correio, essa definição da caixa de correio substituirá o valor que está definido neste atributo no banco de dados da caixa de correio.

ProhibitSendReceiveQuota

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ProhibitSendReceiveQuota especifica o tamanho da caixa de correio na qual o respectivo usuário associado não poderá mais enviar ou receber mensagens.

Você deve especificar um inteiro ou "ilimitado."

Se você definir este atributo em uma caixa de correio, essa definição da caixa de correio substituirá o valor que está definido neste atributo no banco de dados da caixa de correio.

RecipientLimits

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro RecipientLimits especifica o número máximo de destinatários por mensagem aos quais esta caixa de correio pode enviar.

Você deve especificar um inteiro ou "ilimitado."

Se você definir esse atributo em uma caixa de correio, essa definição da caixa de correio substituirá o valor definido para esse atributo no servidor de transporte de hub.

RejectMessagesFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFrom especifica os destinatários cujas mensagens serão rejeitadas.

RejectMessagesFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFromDLMembers especifica listas de distribuição. As mensagens de qualquer membro dessas listas de distribuição serão rejeitadas.

RemoveManagedFolderAndPolicy

Opcional

System.Management.Automation.SwitchParameter

No Exchange 2007 Service Pack 1, você pode usar o parâmetro RemoveManagedFolderAndPolicy para remover todas as diretivas de MRM e atributos de uma caixa de correio. Se você usar esse parâmetro, as diretivas e as propriedades de MRM de qualquer pasta gerenciada que for criada como parte de qualquer diretiva de MRM serão removidas, as pastas gerenciadas que estiverem vazias serão removidas da caixa de correio e as que tiverem itens serão convertidas em pastas padrão.

RequireSenderAuthenticationEnabled

Opcional

System.Boolean

O parâmetro RequireSenderAuthenticationEnabled especifica se os remetentes devem ser autenticados. Os dois valores possíveis para esse parâmetro são $true ou $false.

ResourceCapacity

Opcional

System.Nullable

O parâmetro ResourceCapacity especifica a capacidade, se esta caixa de correio for uma caixa de correio de recurso.

Você deve especificar um inteiro não negativo.

ResourceCustom

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ResourceCustom especifica informações adicionais sobre o recurso. Você pode definir propriedades personalizadas para caixas de correio de recursos usando o comando Set-ResourceConfig e usar esse parâmetro para definir essas propriedades personalizadas.

RetainDeletedItemsFor

Opcional

Microsoft.Exchange.Data.EnhancedTimeSpan

O parâmetro RetainDeletedItemsFor especifica por quanto tempo manter itens excluídos. Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss em que d = dias, h = horas, m = minutos e s = segundos. Por exemplo, para especificar um intervalo de 15 horas, digite 15:00:00.

RetainDeletedItemsUntilBackup

Opcional

System.Boolean

O parâmetro RetainDeletedItemsUntilBackup especifica se deve manter itens excluídos até o próximo backup. Os dois valores possíveis para esse parâmetro são $true ou $false.

RetentionHoldEnabled

Opcional

System.Boolean

O parâmetro RetentionHoldEnabled especifica se a retenção está habilitada para o MRM. Os dois valores possíveis para esse parâmetro são $true ou $false. Para definir a data de início da retenção, use o parâmetro StartDateForRetentionHold.

RulesQuota

Opcional

Microsoft.Exchange.Data.ByteQuantifiedSize

O parâmetro RulesQuota especifica o limite do tamanho de regras para esta caixa de correio. Quando você inserir um valor, qualifique-o com um dos itens a seguir:

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Os valores não qualificados são considerados bytes.

O valor padrão deste parâmetro é 64 KB. O valor máximo deste parâmetro é 256 KB.

Dica

A cota para regras de caixa de correio se aplica apenas a regras habilitadas. Não há restrição ao número de regras desabilitadas que uma caixa de correio pode ter. Porém, o tamanho total das regras habilitadas, ou ativas, não pode exceder o valor especificado para este parâmetro.

SamAccountName

Opcional

System.String

O parâmetro SamAccountName especifica o nome de usuário para sistemas operacionais anteriores, como Windows NT 4.0, Windows 98, Windows 95 e LAN Manager. O parâmetro é usado para oferecer suporte a clientes e servidores que estejam executando versões antigas do sistema operacional. Esse atributo deve ter menos de 20 caracteres.

SCLDeleteEnabled

Opcional

System.Nullable

O parâmetro SCLDeleteEnabled especifica se as mensagens que atendem o limite de SCL (nível de confiança de spam) especificado pelo parâmetro SCLDeleteThreshold serão excluídas. É possível usar os seguintes valores:

  • $true

  • $false

  • $null

SCLDeleteThreshold

Opcional

System.Nullable

O parâmetro SCLDeleteThreshold especifica o SCL no qual uma mensagem será excluída se o parâmetro SCLDeleteEnabled estiver definido como $true.

Você deve especificar um número inteiro entre 0 e 9, inclusive.

SCLJunkEnabled

Opcional

System.Nullable

O parâmetro SCLJunkEnabled especifica se as mensagens que atendem o limite de SCL especificado pelo parâmetro SCLJunkThreshold serão movidas para a pasta Lixo Eletrônico. É possível usar os seguintes valores:

  • $true

  • $false

  • $null

SCLJunkThreshold

Opcional

System.Nullable

O parâmetro SCLJunkThreshold especifica o limite de SCL. Mensagens com um SCL superior ao valor especificado para o parâmetro SCLJunkThreshold serão movidas para a pasta Lixo Eletrônico, se o parâmetro SCLJunkEnabled for definido como $true.

Você deve especificar um número inteiro entre 0 e 9, inclusive.

SCLQuarantineEnabled

Opcional

System.Nullable

O parâmetro SCLQuarantineEnabled especifica se as mensagens que atendem o limite de SCL especificado pelo parâmetro SCLQuarantineThreshold serão colocadas em quarentena. Se uma mensagem for colocada em quarentena, ela será enviada para a caixa de correio de quarentena onde o administrador de mensagens poderá revisá-la. É possível usar os seguintes valores:

  • $true

  • $false

  • $null

SCLQuarantineThreshold

Opcional

System.Nullable

O parâmetro SCLQuarantineThreshold especifica o SCL no qual uma mensagem será colocada em quarentena se o parâmetro SCLQuarantineEnabled estiver definido como $true.

Você deve especificar um número inteiro entre 0 e 9, inclusive.

SCLRejectEnabled

Opcional

System.Nullable

O parâmetro SCLRejectEnabled especifica se as mensagens que atendem o limite de SCL especificado pelo parâmetro SCLRejectThreshold serão rejeitadas. Se uma mensagem for rejeitada, ela será excluída e uma resposta de rejeição será enviada ao remetente. É possível usar os seguintes valores:

  • $true

  • $false

  • $null

SCLRejectThreshold

Opcional

System.Nullable

O parâmetro SCLRejectThreshold especifica o SCL no qual uma mensagem será rejeitada se o parâmetro SCLRejectEnabled estiver definido como $true.

Você deve especificar um número inteiro entre 0 e 9, inclusive.

SecondaryAddress

Opcional

System.String

Esse parâmetro especifica o endereço secundário usado pelo usuário habilitado para UM.

SecondaryDialPlan

Opcional

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Esse parâmetro especifica um plano de discagem de UM secundário a ser usado. Esse parâmetro é fornecido para criar um endereço de proxy secundário.

SimpleDisplayName

Opcional

System.String

O parâmetro SimpleDisplayName é usado em objetos em que o nome do objeto pode ser exibido em um ambiente que não tenha suporte para caracteres Unicode. Os únicos caracteres com suporte no parâmetro SimpleDisplayName são caracteres ASCII de 26 a 126, inclusive. Esses caracteres são aqueles normalmente encontrados na maioria dos teclados em inglês americano.

StartDateForRetentionHold

Opcional

System.Nullable

O parâmetro StartDateForRetentionHold especifica a data de início para retenção de MRM. Para usar este parâmetro, é necessário que o parâmetro RetentionHoldEnabled seja definido como $true.

Type

Opcional

Microsoft.Exchange.Management.RecipientTasks.ConvertibleMailboxSubType

O parâmetro Type especifica o tipo da caixa de correio. É possível usar os seguintes valores:

  • Regular

  • Room

  • Equipment

  • Shared

UMDtmfMap

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica se você deseja criar um mapa de DTMF definido pelo usuário para o usuário habilitado para UM.

UseDatabaseQuotaDefaults

Opcional

System.Nullable

O parâmetro UseDatabaseQuotaDefaults especifica se esta caixa de correio usa os atributos de cota especificados para o banco de dados de caixa de correio em que esta caixa de correio reside. Os atributos de cota são:

  • ProhibitSendQuota

  • ProhibitSendReceiveQuota

  • IssueWarningQuota

  • RulesQuota

Os dois valores possíveis para esse parâmetro são $true ou $false.

UseDatabaseRetentionDefaults

Opcional

System.Boolean

O parâmetro UseDatabaseRetentionDefaults especifica se esta caixa de correio usa o atributo MailboxRetention especificado para o banco de dados de caixa de correio em que esta caixa de correio reside.

Os dois valores possíveis para esse parâmetro são $true ou $false.

UserPrincipalName

Opcional

System.String

O parâmetro UserPrincipalName especifica o nome UPN dessa caixa de correio. É o nome de logon do usuário. O UPN consiste em um nome de usuário e um sufixo. Geralmente, o sufixo é o nome do domínio em que a conta do usuário reside.

UseRusServer

Opcional

System.String

O parâmetro UseRusServer instrui o comando a utilizar o servidor de Serviço de Atualização de Destinatário especificado para obter e definir a caixa de correio e os atributos do usuário do Active Directory.

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á exibir 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 o endereço de email do Windows desta caixa de correio. Esse endereço não é usado pelo Exchange.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

O primeiro exemplo mostra como encaminhar mensagens de email de John Peoples para a caixa de correio de Jose de Oliveira (jose@contoso.com).

O segundo exemplo usa o comando Get-Mailbox para localizar todas as caixas de correio na unidade organizacional (UO) Marketing e, em seguida, usa o comando Set-Mailbox para configurar essas caixas de correio. Os limites personalizados de avisos, proibição de envios e proibição de envios e recebimentos estão definidos como 200 megabytes (MB), 250 MB e 280 MB, respectivamente, e os limites padrão de bancos de dados de caixa de correio são ignorados. Esse comando pode ser usado para configurar um conjunto específico de caixas de correio para que tenham limites maiores ou menores do que outras caixas de correio na organização.

O terceiro exemplo usa o comando Get-User para localizar todos os usuários no departamento Customer Service e, em seguida, usa o comando Set-Mailbox para alterar o tamanho máximo de mensagens enviadas para 2 MB.

Set-Mailbox -Identity John -DeliverToMailboxAndForward $true -ForwardingAddress jose@contoso.com 
Get-Mailbox -OrganizationalUnit "Marketing" | Set-Mailbox -IssueWarningQuota 209715200 -ProhibitSendQuota 262144000 -ProhibitSendReceiveQuota 293601280 -UseDatabaseQuotaDefaults $false 
Get-User -Filter "Department -eq 'Customer Service'" | Set-Mailbox -MaxSendSize 2097152