Set-EmailAddressPolicy
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Utilize o cmdlet Set-EmailAddressPolicy para modificar as políticas de endereço de e-mail. No Exchange Online, as políticas de endereços de e-mail só estão disponíveis para Grupos do Microsoft 365.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
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 utilizar o cmdlet Set-EmailAddressPolicy para modificar uma política de endereço de e-mail numa organização do Exchange no local, tem de utilizar 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 utilizem qualquer propriedade de destinatário disponível e que não estejam sujeitas a estas limitações, pode utilizar o parâmetro RecipientFilter para criar um filtro OPATH personalizado.
Não pode utilizar este cmdlet para substituir um filtro pré-estranho por um filtro OPATH personalizado ou vice-versa. Só pode modificar o filtro existente.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-EmailAddressPolicy -Identity "Southeast Executives" -ConditionalStateOrProvince @{Add="TX"}
No Exchange no local, este exemplo modifica a política de endereços de e-mail existente denominada Southeast Executives ao adicionar o valor de Estado ou província TX (Texas) ao filtro de destinatários pré-selecionado.
Exemplo 2
Set-EmailAddressPolicy -Identity "Contoso Corp" -DisabledEmailAddressTemplates $null
No Exchange no local, este exemplo limpa os modelos de endereço de e-mail desativados da política de endereço de e-mail denominada Contoso Corp.
Exemplo 3
Set-EmailAddressPolicy -Identity "Office 365 Groups" -EnabledEmailAddressTemplates "SMTP:@contoso.com","smtp:@contoso.onmicrosoft.com","smtp:@contoso.microsoftonline.com"
No Exchange Online, este exemplo modifica a política de endereço de e-mail existente denominada "grupos de Office 365" e define os modelos de endereço de e-mail ativados para utilizar "@contoso.com" como o endereço SMTP principal e "@contoso.onmicrosoft.com" e "@contoso.microsoftonline.com" como endereços proxy.
Parâmetros
-ConditionalCompany
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCompany especifica um filtro pré-estranho baseado no valor da propriedade Empresa do destinatário.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute1
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute1 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute1 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute10
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute10 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute10 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute11
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute11 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute11 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute12
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute12 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute12 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute13
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute13 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute13 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute14
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute14 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute14 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute15
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute15 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute15 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute2
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute2 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute2 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute3
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute3 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute3 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute4
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute4 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute4 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute5
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute5 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute5 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute6
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute6 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute6 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute7
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute7 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute7 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute8
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute8 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute8 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalCustomAttribute9
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalCustomAttribute9 especifica um filtro pré-estranho baseado no valor da propriedade CustomAttribute9 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalDepartment
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalDepartment especifica um filtro pré-estranho baseado no valor da propriedade Departamento do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConditionalStateOrProvince
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro ConditionalStateOrProvince especifica um filtro pré-estranho baseado no valor da propriedade StateOrProvince do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando utiliza vários valores para este parâmetro, é aplicado o operador Booleano OR. Para obter mais informações sobre como funcionam os parâmetros condicionais, veja a secção Descrição Detalhada deste artigo.
Para introduzir vários valores que substituem todas as entradas existentes, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
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 estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DisabledEmailAddressTemplates
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DisabledEmailAddressTemplates especifica os modelos de endereços de e-mail proxy incluídos numa política de endereço de e-mail, mas não são utilizados para configurar os endereços de e-mail dos destinatários.
A sintaxe válida para este parâmetro é Type:AddressFormat:
- Tipo: um tipo de endereço de e-mail válido, conforme descrito na secção "Tipos de endereço" no Email políticas de endereço no Exchange Server. Por exemplo, smtp ou X400. Não pode utilizar o SMTP para especificar um endereço de e-mail SMTP principal desativado.
- AddressFormat: para endereços de e-mail SMTP, um domínio ou subdomínio configurado como domínio aceite (reencaminhamento autoritativo ou interno) e variáveis válidas e carateres de texto ASCII, conforme descrito na secção "Formatos de endereço" no Email políticas de endereços no Exchange Server. Por exemplo: alias@contoso.com requer o valor
%m@contoso.come firstname.lastname@contoso.com requer o valor%g.%s@contoso.com.
Pode especificar vários modelos de endereços de e-mail desativados separados por vírgulas: "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".
Normalmente, esta propriedade só é preenchida por valores após uma migração de uma versão anterior do Exchange. Para limpar estes valores, utilize o valor $null para este parâmetro.
Propriedades do parâmetro
| Tipo: | ProxyAddressTemplateCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EnabledEmailAddressTemplates
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
Para configurar os tipos de arquivo bloqueados, use o parâmetro FileTypes.
A sintaxe válida para este parâmetro é Type:AddressFormat:
- Tipo: um tipo de endereço de e-mail válido, conforme descrito na secção "Tipos de endereço" na Email políticas de endereços no Exchange Server. Por exemplo, SMTP para o endereço de email principal e smtp para endereços proxy.
- AddressFormat: para endereços de e-mail SMTP, um domínio ou subdomínio configurado como domínio aceite (reencaminhamento autoritativo ou interno) e variáveis válidas e carateres de texto ASCII, conforme descrito na secção "Formatos de endereço" no Email políticas de endereços no Exchange Server. Por exemplo: alias@contoso.com requer o valor
%m@contoso.come firstname.lastname@contoso.com requer o valor%g.%s@contoso.com.
Este parâmetro requer, pelo menos, um modelo com o valor Tipo SMTP (para definir o endereço de e-mail SMTP principal). Depois disso, se não incluir um prefixo Tipo para um modelo, é assumido o valor smtp (um endereço proxy SMTP).
Pode especificar vários modelos de endereços de e-mail separados por vírgulas: "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".
Não pode utilizar este parâmetro com o parâmetro EnabledPrimarySMTPAddressTemplate.
No Exchange Online PowerShell, se utilizar este parâmetro com os IncludeUnifiedGroupRecipients, não poderá utilizar variáveis no modelo de endereço de e-mail.
Propriedades do parâmetro
| Tipo: | ProxyAddressTemplateCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-EnabledPrimarySMTPAddressTemplate
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro EnabledPrimarySMTPAddressTemplate especifica a regra na política de endereço de e-mail utilizada para gerar os endereços de e-mail SMTP principais para destinatários. Pode utilizar este parâmetro em vez de EnabledEmailAddressTemplates se a política aplicar apenas o endereço de email principal e nenhum endereço proxy adicional.
A sintaxe válida para este parâmetro é um domínio ou subdomínio configurado como um domínio aceite autoritativo e variáveis válidas e carateres de texto ASCII, conforme descrito na secção "Formato de endereço" no Email políticas de endereço no Exchange Server. Por exemplo: alias@contoso.com requer o valor %m@contoso.come firstname.lastname@contoso.com requer o valor %g.%s@contoso.com.
Não pode utilizar este parâmetro com o parâmetro EnabledEmailAddressTemplates.
No Exchange Online PowerShell, se utilizar este parâmetro com os IncludeUnifiedGroupRecipients, não poderá utilizar variáveis no modelo de endereço de e-mail.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ForceUpgrade
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O comutador ForceUpgrade suprime a mensagem de confirmação que aparece se o objeto tiver sido criado numa versão anterior do Exchange. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro Identidade especifica a política de endereço de e-mail que pretende modificar. É possível usar qualquer valor que identifique a política com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Propriedades do parâmetro
| Tipo: | EmailAddressPolicyIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludedRecipients
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro IncludedRecipients especifica um filtro pré-selecionado baseado no tipo de destinatário. Os valores válidos são:
- AllRecipients: este valor só pode ser utilizado por si só.
- Caixas de CorreioUtilizadores
- MailContacts
- MailGroups
- MailUsers
- MailUsers
Vários valores, separados por vírgulas, podem ser especificados. Quando utiliza vários valores, é aplicado o operador Booleano OR.
Propriedades do parâmetro
| Tipo: | WellKnownRecipientType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro Nome especifica o nome exclusivo da política de endereço de e-mail. O tamanho máximo é de 64 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Priority
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
O parâmetro Priority especifica a ordem pela qual as políticas de endereço de e-mail são avaliadas. Por predefinição, sempre que adicionar uma nova política de endereço de e-mail, é atribuída à política uma prioridade de N+1, em que N é o número de políticas de endereço de e-mail que 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.
Nota: a primeira política de endereço de e-mail que identifica um destinatário configura os endereços de e-mail 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.
Propriedades do parâmetro
| Tipo: | EmailAddressPolicyPriority |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecipientContainer
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro RecipientContainer especifica um filtro baseado na localização do destinatário no Active Directory. A entrada válida para este parâmetro é uma unidade organizacional (UO) ou domínio que é devolvido 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
Propriedades do parâmetro
| Tipo: | OrganizationalUnitIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RecipientFilter
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro RecipientFilter especifica um filtro OPATH personalizado baseado no valor de qualquer propriedade de destinatário disponível. Pode utilizar qualquer operador de Windows PowerShell disponível e são suportados carateres universais e correspondências parciais. Os critérios de pesquisa utilizam a sintaxe "Property -ComparisonOperator 'Value'".
- Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo,
$true,$falseou$null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis. - A propriedade é uma propriedade filtráveis. Para obter as propriedades filtráveis, veja Propriedades filtráveis para o parâmetro RecipientFilter.
- ComparisonOperator é um operador de comparação OPATH (por exemplo
-eq, para igual e-likepara comparação de cadeias). Para obter mais informações sobre operadores de comparação, veja about_Comparison_Operators. - Valor é o valor da propriedade a filtrar. Coloque os valores de texto e as variáveis entre plicas (
'Value'ou'$Variable'). Se um valor de variável contiver aspas únicas, terá de identificar (escape) as aspas únicas para expandir a variável corretamente. Por exemplo, em vez de'$User', utilize'$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, utilize500,$true,$falseou$nullem alternativa). - Os carateres universais são válidos apenas como o primeiro ou último caráter. Por exemplo,
'Sales*'ou'*Sales'são permitidos, mas'Sa*les'não são permitidos.
Para obter informações detalhadas sobre filtros OPATH no Exchange, veja Informações adicionais sobre sintaxe OPATH.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para no local caixas de correio
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.