Set-EmailAddressPolicy

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-EmailAddressPolicy para modificar as políticas de endereço de email. No Exchange Online, as políticas de endereço de email só estão disponíveis para os grupos do Microsoft 365.

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

Syntax

Set-EmailAddressPolicy
   [-Identity] <EmailAddressPolicyIdParameter>
   [-ConditionalCompany <MultiValuedProperty>]
   [-ConditionalCustomAttribute1 <MultiValuedProperty>]
   [-ConditionalCustomAttribute10 <MultiValuedProperty>]
   [-ConditionalCustomAttribute11 <MultiValuedProperty>]
   [-ConditionalCustomAttribute12 <MultiValuedProperty>]
   [-ConditionalCustomAttribute13 <MultiValuedProperty>]
   [-ConditionalCustomAttribute14 <MultiValuedProperty>]
   [-ConditionalCustomAttribute15 <MultiValuedProperty>]
   [-ConditionalCustomAttribute2 <MultiValuedProperty>]
   [-ConditionalCustomAttribute3 <MultiValuedProperty>]
   [-ConditionalCustomAttribute4 <MultiValuedProperty>]
   [-ConditionalCustomAttribute5 <MultiValuedProperty>]
   [-ConditionalCustomAttribute6 <MultiValuedProperty>]
   [-ConditionalCustomAttribute7 <MultiValuedProperty>]
   [-ConditionalCustomAttribute8 <MultiValuedProperty>]
   [-ConditionalCustomAttribute9 <MultiValuedProperty>]
   [-ConditionalDepartment <MultiValuedProperty>]
   [-ConditionalStateOrProvince <MultiValuedProperty>]
   [-Confirm]
   [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
   [-DomainController <Fqdn>]
   [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
   [-EnabledPrimarySMTPAddressTemplate <String>]
   [-ForceUpgrade]
   [-IncludedRecipients <WellKnownRecipientType>]
   [-Name <String>]
   [-Priority <EmailAddressPolicyPriority>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-RecipientFilter <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

Depois de usar o cmdlet Set-EmailAddressPolicy para modificar uma política de endereço de email em uma organização local do Exchange, você precisará usar o cmdlet Update-EmailAddressPolicy para aplicar a política atualizada aos destinatários.

Os parâmetros Conditional que são usados com o parâmetro IncludedRecipients estão sujeitos às seguintes limitações:

  • O operador EQV é usado para cada valor de propriedade, como em "Departamento = Vendas". Não há suporte para caracteres curinga e correspondências parciais.

  • O operador OR sempre é usado para vários valores da mesma propriedade, como e "Departamento = Vendas OR Marketing".

  • O operador AND sempre é usado para várias propriedades, como em "Departamento = Vendas AND Empresa = Contoso".

Para criar filtros flexíveis que usem qualquer propriedade de destinatário disponível e que não estejam sujeitos a essas limitações, você pode usar o parâmetro RecipientFilter para criar um filtro OPath personalizado.

Você não pode usar este cmdlet para substituir um filtro predefinido por um filtro OPath personalizado ou vice-versa. Você só pode modificar o filtro existente.

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.

Examples

Exemplo 1

Set-EmailAddressPolicy -Identity "Southeast Executives" -ConditionalStateOrProvince @{Add="TX"}

No Exchange local, este exemplo modifica a política de endereço de email existente chamada sudoeste executivos adicionando o valor de estado ou de província TX (Texas) ao filtro de destinatário predefinido.

Exemplo 2

Set-EmailAddressPolicy -Identity "Contoso Corp" -DisabledEmailAddressTemplates $null

No Exchange local, este exemplo limpa os modelos de endereço de email desabilitados da política de endereço de email chamada Contoso Corp.

Exemplo 3

Set-EmailAddressPolicy -Identity 'Office 365 Groups' -EnabledEmailAddressTemplates "SMTP:@contoso.com","@contoso.onmicrosoft.com","smtp:@contoso.microsoftonline.com"

No Exchange Online, este exemplo modifica a diretiva de endereços de email existente chamada grupos do Office 365, configurando os modelos de endereço de email habilitados como "SMTP: @contoso. com" e "@contoso. onmicrosoft.com" e "SMTP: @contoso. microsoftonline.com". Isso também definirá o modelo de endereço SMTP principal habilitado como "@contoso. com".

Parameters

-ConditionalCompany

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCompany especifica um filtro predefinido com base no valor da propriedade Company do destinatário.

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute1 especifica um filtro predefinido com base no valor da propriedade CustomAttribute1 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute10 especifica um filtro predefinido com base no valor da propriedade CustomAttribute10 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute11 especifica um filtro predefinido com base no valor da propriedade CustomAttribute11 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute12 especifica um filtro predefinido com base no valor da propriedade CustomAttribute12 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute13 especifica um filtro predefinido com base no valor da propriedade CustomAttribute13 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute14 especifica um filtro predefinido com base no valor da propriedade CustomAttribute14 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute15 especifica um filtro predefinido com base no valor da propriedade CustomAttribute15 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute2 especifica um filtro predefinido com base no valor da propriedade CustomAttribute2 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute3 especifica um filtro predefinido com base no valor da propriedade CustomAttribute3 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute4 especifica um filtro predefinido com base no valor da propriedade CustomAttribute4 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute5 especifica um filtro predefinido com base no valor da propriedade CustomAttribute5 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute6 especifica um filtro predefinido com base no valor da propriedade CustomAttribute6 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute7 especifica um filtro predefinido com base no valor da propriedade CustomAttribute7 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute8 especifica um filtro predefinido com base no valor da propriedade CustomAttribute8 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalCustomAttribute9 especifica um filtro predefinido com base no valor da propriedade CustomAttribute9 do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalDepartment especifica um filtro predefinido com base no valor da propriedade Department do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro ConditionalStateOrProvince especifica um filtro predefinido com base no valor da propriedade StateOrProvince do destinatário. SPO: exSharePointOnline2ndMen

Quando você usa vários valores para esse parâmetro, o operador Booleano OR é aplicado. Para obter mais informações sobre como os parâmetros condicionais funcionam, consulte a seção descrição detalhada deste tópico.

Para inserir vários valores que substituem as entradas existentes, use a seguinte sintaxe: <value1> , <value2> ,... <valueN> . Se os valores contiverem espaços ou exigirem aspas, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação 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 confirmar o comando antes de continuar.

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro DisabledEmailAddressTemplates especifica os modelos de endereços de email de proxy incluídos em uma política de endereço de email, mas não são usados para configurar os endereços de email dos destinatários.

A sintaxe válida para esse parâmetro é <Type> : <AddressFormat> :

  • <Type>: Um tipo de endereço de email válido, conforme descrito na seção "tipos de endereço" nas políticas de endereço de email no Exchange Server. Por exemplo, SMTP ou X400. Observe que você não pode usar SMTP para especificar um endereço de email SMTP principal desabilitado.

  • <AddressFormat>: Para endereços de email SMTP, um domínio ou subdomínio configurado como domínio aceito (retransmissão autoritativa ou interna) e variáveis válidas e caracteres de texto ASCII, conforme descrito na seção "formatos de endereço" em políticas de endereço de email no Exchange Server. Por exemplo: <alias> @contoso. com requer o valor% m@contoso.com e <firstname> . <lastname> @contoso. com requer o valor% g.%s@contoso.com.

Você pode especificar vários modelos de endereços de email desativados separados por vírgulas: "[ <Type1> ]: <EmailAddress1> ", "[ <Type2> ]: <EmailAddress2> ",... "[ <TypeN> ]: <EmailAddressN> ".

Normalmente, essa propriedade é preenchida apenas por valores após uma migração de uma versão anterior do Exchange. Para limpar esses valores, use o valor $null para esse parâmetro.

Type:ProxyAddressTemplateCollection
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-EnabledEmailAddressTemplates

Para configurar os tipos de arquivo bloqueados, use o parâmetro FileTypes.

A sintaxe válida para esse parâmetro é <Type> : <AddressFormat> :

  • <Type>: Um tipo de endereço de email válido, conforme descrito na seção "tipos de endereço" nas políticas de endereço de email no Exchange Server. Por exemplo, SMTP para o endereço de email principal e SMTP para endereços proxy.

  • <AddressFormat>: Para endereços de email SMTP, um domínio ou subdomínio configurado como domínio aceito (retransmissão autoritativa ou interna) e variáveis válidas e caracteres de texto ASCII, conforme descrito na seção "formatos de endereço" em políticas de endereço de email no Exchange Server. Por exemplo: <alias> @contoso. com requer o valor% m@contoso.com e <firstname> . <lastname> @contoso. com requer o valor% g.%s@contoso.com.

Esse parâmetro requer pelo menos um modelo com o <Type> valor SMTP (para definir o endereço de email SMTP principal). Depois, se você não incluir um <Type> prefixo para um modelo, o valor SMTP (um endereço de proxy SMTP) será usado.

Você pode especificar vários modelos de endereço de email separados por vírgulas: "SMTP: <PrimarySMTPEmailAddress> ", "[ <Type1> ]: <EmailAddress1> ", "[ <Type2> ]: <EmailAddress2> ",... "[ <TypeN> ]: <EmailAddressN> ".

Você não pode usar esse parâmetro com o parâmetro EnabledPrimarySMTPAddressTemplate.

No PowerShell do Exchange Online, se você usar esse parâmetro com o IncludeUnifiedGroupRecipients, não será possível usar variáveis no modelo de endereço de email.

Type:ProxyAddressTemplateCollection
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-EnabledPrimarySMTPAddressTemplate

O parâmetro EnabledPrimarySMTPAddressTemplate especifica a regra na política de endereço de email usada para gerar os endereços de email SMTP primários para destinatários. Você pode usar esse parâmetro em vez do EnabledEmailAddressTemplates se a política só aplicar o endereço de email principal e nenhum endereço de proxy adicional.

A sintaxe válida para esse parâmetro é um domínio ou subdomínio que está configurado como um domínio autoritativo com autoridade, e variáveis válidas e caracteres de texto ASCII, conforme descrito na seção "formato de endereço" em políticas de endereço de email no Exchange Server. Por exemplo: <alias> @contoso. com requer o valor% m@contoso.com e <firstname> . <lastname> @contoso. com requer o valor% g.%s@contoso.com.

Você não pode usar esse parâmetro com o parâmetro EnabledEmailAddressTemplates.

No PowerShell do Exchange Online, se você usar esse parâmetro com o IncludeUnifiedGroupRecipients, não será possível usar variáveis no modelo de endereço de email.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-ForceUpgrade

A opção ForceUpgrade especifica se é preciso suprimir a mensagem de confirmação que aparecerá se o objeto foi criado em uma versão anterior do Exchange. Não é preciso especificar um valor com essa opção.

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

O parâmetro Identity especifica a política de endereço de email que você deseja modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:

  • Nome

  • DN (nome diferenciado)

  • GUID

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro IncludedRecipients especifica um filtro predefinido baseado no tipo de destinatário. Os valores válidos são:

  • Destinatários: esse valor pode ser usado apenas por ele mesmo.

  • MailboxUsers

  • MailContacts

  • MailGroups

  • MailUsers

  • MailUsers

SPO: exSharePointOnline2ndMen Quando você usa vários valores, o operador Booleano OR é aplicado.

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

O parâmetro Name especifica o nome exclusivo para a política de endereço de email. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Priority

O parâmetro Priority especifica a ordem em que as políticas de endereço de email são avaliadas. Por padrão, toda vez que você adiciona uma nova política de endereço de email, a política recebe uma prioridade N + 1, onde N é o número de políticas de endereço de email que você criou.

O parâmetro Priority especifica a ordem em que as políticas de endereço de email são avaliadas. Por padrão, cada vez que você adicionar uma nova política de endereço de email, será atribuída a ela uma prioridade de N+1, em que N é o número de políticas de endereço de email que você criou.

Observação: a primeira política de endereço de email que identifica um destinatário configura os endereços de email do destinatário. Todas as outras políticas serão ignoradas, mesmo se a primeira política não for aplicada e não conseguir configurar os endereços de email do destinatário.

Type:EmailAddressPolicyPriority
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-RecipientContainer

Este parâmetro está disponível somente no Exchange local.

O parâmetro RecipientContainer especifica um filtro com base no local do destinatário no Active Directory. A entrada válida para esse parâmetro é uma UO (unidade organizacional) ou um domínio retornado pelo cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

  • Nome

  • Nome

  • Nome diferenciado (DN)

  • GUID

GUID

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

Este parâmetro está disponível somente no Exchange local.

O parâmetro RecipientFilter especifica um filtro OPath personalizado com base no valor de qualquer propriedade de destinatário disponível. Você pode usar qualquer operador do Windows PowerShell disponível, e curingas e correspondências parciais têm suporte. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'" .

  • Coloque todo o filtro OPath entre aspas duplas "". Se o filtro contiver valores de sistema (por exemplo,, $true $false ou $null ), use aspas simples. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco de sistema), você também pode usar chaves {}, mas somente se o filtro não contiver variáveis.

  • Propriedade é uma propriedade filtrável. Para propriedades filtráveis, confira Propriedades filtráveis para o parâmetro RecipientFilter.

  • ComparisonOperator é um operador de comparação de OPath (por exemplo -eq , igual a e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.

  • Value é o valor da propriedade a ser filtrado. Coloque valores de texto e variáveis entre aspas simples ( 'Value' ou '$Variable' ). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User' , use '$($User -Replace "'","''")' . Não coloque números inteiros ou valores do sistema (por exemplo,,, 500 $true $false ou $null ).

  • Os curingas são válidos somente como o primeiro ou o último caractere. Por exemplo, 'Sales*' ou '*Sales' são permitidos, mas 'Sa*les' não são permitidos.

Para obter informações detalhadas sobre filtros do OPath no Exchange, consulte Additional OPATH Syntax Information.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Inputs

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.

Outputs

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.