New-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 ambiente ou de outro.
Use o cmdlet New-EmailAddressPolicy para criar políticas de endereço de email. No Exchange Online, as políticas de endereço de email estão disponíveis apenas para Grupos do Microsoft 365.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
AllTemplatesWithPrecannedFilter
New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-IncludedRecipients <WellKnownRecipientType>
[-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>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
AllTemplatesWithCustomFilter
New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-RecipientFilter <String>
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
SMTPTemplateWithPrecannedFilter
New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-IncludedRecipients <WellKnownRecipientType>
[-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]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
SMTPTemplateWithCustomFilter
New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
AllTemplatesForUnifiedGroupRecipientsFilter
New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
SMTPTemplateForUnifiedGroupRecipientsFilter
New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>]
Description
Depois de usar o cmdlet New-EmailAddressPolicy para criar 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 nova política 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 usam qualquer propriedade de destinatário disponível e que não estão sujeitos a essas limitações, você pode usar o parâmetro RecipientFilter para criar um filtro OPATH.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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.
Exemplos
Exemplo 1
New-EmailAddressPolicy -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA" -EnabledEmailAddressTemplates "SMTP:%s%2g@southeast.contoso.com","smtp:%s%2g@southeast.contoso.net"
Este exemplo cria uma política de endereço de email em uma organização local do Exchange que usa um filtro de destinatário predefinido:
- Nome: Escritórios do Sudeste
- Filtro de destinatário predefinido: todos os usuários com caixas de correio em que o valor Estado ou província é GA, AL ou LA (Geórgia, Alabama ou Louisiana).
- Endereço de email SMTP primário:
<last name>.<first two letters of the first name>@contoso.com - Endereços de email proxy adicionais:
<last name>.<first two letters of the first name>@contoso.net - Prioridade:N+1, onde N é o número de políticas de endereço de email criadas manualmente que já existem (não usamos o parâmetro Prioridade e o valor padrão é N+1).
Exemplo 2
New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')" -EnabledEmailAddressTemplates "SMTP:%2g%s@contoso.com" -Priority 2
Este exemplo cria uma política de endereço de email em uma organização local do Exchange que usa um filtro de destinatário personalizado:
- Nome: Northwest Executives
- Filtro de destinatário personalizado: todos os usuários com caixas de correio em que o valor Título contém Diretor ou Gerente e o valor Estado ou província é WA, OR ou ID (Washington, Oregon ou Idaho).
- Endereço de email SMTP primário:
<first two letters of the first name><last name>@contoso.com - Endereços de email proxy adicionais: Nenhum
- Prioridade: 2
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 predefinido com base no valor da propriedade Company do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute1 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute10 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute11 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute12 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute13 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute14 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute15 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute2 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute3 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute4 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute5 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute6 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute7 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute8 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade CustomAttribute9 do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade Department do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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 predefinido com base no valor da propriedade StateOrProvince do destinatário. Vários valores, separados por vírgulas, podem ser especificados.
Quando você usa vários valores para esse parâmetro, o operador booleano OR é aplicado. Para obter mais informações sobre como funcionam os parâmetros condicionais, consulte a seção Descrição detalhada deste artigo.
Você usa esse parâmetro em combinação com o parâmetro IncludedRecipients como parte de um filtro predefinido. Você não pode usar nenhum parâmetro condicional em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| 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
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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 email 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 este parâmetro é Type:AddressFormat:
- Tipo: 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. Você não pode usar SMTP para especificar um endereço de email SMTP primário 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" nas políticas de endereço de Email 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.
Você pode especificar vários modelos de endereço de email desabilitados separados por vírgulas: "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".
Propriedades do parâmetro
| Tipo: | ProxyAddressTemplateCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
AllTemplatesWithCustomFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
AllTemplatesForUnifiedGroupRecipientsFilter
| 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
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 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" nas políticas de endereço de Email 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.
Esse parâmetro requer pelo menos um modelo com o valor Type SMTP (para definir o endereço de email SMTP principal). Depois disso, se você não incluir um prefixo Type para um modelo, o valor smtp (um endereço proxy SMTP) será assumido.
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 Exchange Online PowerShell, você não pode usar variáveis no modelo de endereço de email.
Propriedades do parâmetro
| Tipo: | ProxyAddressTemplateCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
AllTemplatesWithCustomFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
AllTemplatesForUnifiedGroupRecipientsFilter
| Cargo: | Named |
| Obrigatório: | True |
| 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
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 os destinatários. Você poderá usar esse parâmetro em vez de EnabledEmailAddressTemplates se a política aplicar apenas 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 configurado como um domínio aceito autoritativa, além de variáveis válidas e caracteres de texto ASCII, conforme descrito na seção "Formato de endereço" nas políticas de endereço de Email 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 é possível usar esse parâmetro com o parâmetro EnabledEmailAddressTemplates.
No Exchange Online PowerShell, você não pode usar variáveis no modelo de endereço de email.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SMTPTemplateWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithCustomFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateForUnifiedGroupRecipientsFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| 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 predefinido com base no tipo de destinatário. Os valores válidos são:
- AllRecipients: esse valor só pode ser usado por si só.
- MailboxUsers
- Contatos de Email
- Grupos de Email
- Usuários de Email
- MailUsers
Vários valores, separados por vírgulas, podem ser especificados. Quando você usa vários valores, o operador booleano OR é aplicado.
Você precisa usar esse parâmetro ao usar qualquer parâmetro condicional como parte de um filtro predefinido. Você não pode usar esse parâmetro em combinação com o parâmetro RecipientFilter (que é usado para criar filtros OPATH personalizados).
Propriedades do parâmetro
| Tipo: | WellKnownRecipientType |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithPrecannedFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IncludeUnifiedGroupRecipients
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
A opção IncludeUnifiedGroupRecipients especifica que a política de endereço de email se aplica somente aos Grupos do Microsoft 365. Não é preciso especificar um valor com essa opção.
No Exchange Online PowerShell, você sempre precisa usar essa opção, pois as políticas de endereço de email no Exchange Online são aplicadas apenas a grupos do Microsoft 365.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesForUnifiedGroupRecipientsFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateForUnifiedGroupRecipientsFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ManagedByFilter
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro ManagedByFilter especifica as políticas de endereço de email a serem aplicadas aos Grupos do Microsoft 365 com base nas propriedades dos usuários que criam os Grupos do Microsoft 365.
Esse parâmetro é um filtro OPATH baseado no valor de qualquer propriedade de destinatário disponível (por exemplo, "Department -eq 'Sales'"). Você pode usar qualquer operador do Windows PowerShell disponível, e há suporte para caracteres curinga e correspondências parciais. O critério de pesquisa usa a sintaxe "Property -ComparisonOperator 'Value'".
- Coloque todo o filtro OPATH entre aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo,
$true,$false, ou$null), use aspas simples " '. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também poderá usar chaves { }, mas somente se o filtro não contiver variáveis. - A propriedade é uma propriedade filtrável. Para propriedades de destinatário filtráveis, consulte Propriedades filtráveis para o parâmetro RecipientFilter.
- ComparisonOperator é um operador de comparação OPATH (por exemplo,
-eqpara igual e-likepara comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators. - Valor é o valor da propriedade a ser pesquisado. Coloque os 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 entre aspas (por exemplo, use500,$true,$false, ou$nullem vez disso). - Você não pode usar um caractere curinga como o primeiro caractere. Por exemplo,
'Sales*'é permitido, mas'*Sales'não é permitido.
Para obter mais informações, consulte Escolher o domínio a ser usado ao criar Grupos do Microsoft 365.
Para obter informações detalhadas sobre filtros OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.
Você só pode usar esse parâmetro no Exchange Online PowerShell com a opção IncludeUnifiedGroupRecipients.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesForUnifiedGroupRecipientsFilter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateForUnifiedGroupRecipientsFilter
| 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
O parâmetro Name especifica o nome exclusivo da política de endereço de email. 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: | 1 |
| Obrigatório: | True |
| 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
O parâmetro Priority especifica a ordem em que as políticas de endereço de email são avaliadas. Por padrão, sempre que você adiciona uma nova política de endereço de email, a política recebe uma prioridade de 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 política de primeiro 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.
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 esse parâmetro é uma UO (unidade organizacional) ou 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
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 com base no valor de qualquer propriedade de destinatário disponível. Você pode usar qualquer operador do Windows PowerShell disponível, e há suporte para caracteres curinga e correspondências parciais. O critério de pesquisa usa a sintaxe "Property -ComparisonOperator 'Value'".
- Coloque todo o filtro OPATH entre aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo,
$true,$false, ou$null), use aspas simples " '. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também poderá usar chaves { }, mas somente se o filtro não contiver variáveis. - A propriedade é uma propriedade filtrável. Para propriedades filtráveis, consulte Propriedades filtráveis para o parâmetro RecipientFilter.
- ComparisonOperator é um operador de comparação OPATH (por exemplo,
-eqpara igual e-likepara comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators. - Valor é o valor da propriedade a ser filtrado. Coloque os 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 entre aspas (por exemplo, use500,$true,$false, ou$nullem vez disso). - Em ambientes baseados em nuvem, você não pode usar um caractere curinga como o primeiro caractere. Por exemplo,
'Sales*'é permitido, mas'*Sales'não é permitido. - No Exchange local, os caracteres curinga são válidos apenas 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 OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.
Não é possível usar esse parâmetro em combinação com o parâmetro IncludedRecipients ou quaisquer parâmetros condicionais (que são usados para criar filtros predefinidos).
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AllTemplatesWithCustomFilter
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
SMTPTemplateWithCustomFilter
| Cargo: | Named |
| Obrigatório: | True |
| 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
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.