Add-IPAllowListProvider
Este cmdlet só está disponível ou em vigor em servidores de Transporte Edge no Exchange no local.
Use o cmdlet Add-IPAllowListProvider para criar provedores de lista de Permissões de IP, que são usados pelo agente de Filtragem de Conexão nos servidores Transporte de Borda.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Add-IPAllowListProvider
[-Name] <String>
-LookupDomain <SmtpDomain>
[-AnyMatch <Boolean>]
[-BitmaskMatch <IPAddress>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IPAddressesMatch <MultiValuedProperty>]
[-Priority <Int32>]
[-WhatIf]
[<CommonParameters>]
Description
Nos servidores de Transporte de Borda, você deve ser um membro do grupo local de administradores para executar esse cmdlet.
Exemplos
Exemplo 1
Add-IPAllowListProvider -Name "Contoso.com Allow List" -LookupDomain allowlist.contoso.com -AnyMatch $true
Este exemplo adiciona um novo provedor de lista de Permissões de IP e configura o agente de filtragem de conexão para tratar qualquer código de status de endereço IP, retornado do provedor de lista de Permissões de IP, como uma correspondência e autorizar a conexão. Você obtém o valor do parâmetro LookupDomain no provedor de lista de permissões.
Exemplo 2
Add-IPAllowListProvider -Name "Fabrikam.com Allow List" -LookupDomain allowlist.fabrikam.com -BitmaskMatch 127.1.0.1
Este exemplo adiciona um provedor de lista de Permissões de IP e configura um valor de retorno de bitmask do provedor. Você obtém o valor dos parâmetros LookupDomain e BitmaskMatch no provedor de lista de permissões.
Parâmetros
-AnyMatch
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro AnyMatch especifica se qualquer resposta do provedor de lista de permissões é tratada como uma correspondência. A entrada válida para esse parâmetro é $true ou $false. O valor predefinido é $false. Quando esse parâmetro é configurado como $true e a filtragem de conexão envia o endereço IP do servidor SMTP da conexão para o provedor de lista de permissões, qualquer código de resposta retornado pelo provedor de lista de permissões faz com que a filtragem de conexão permita mensagens dessa origem.
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-BitmaskMatch
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro BitmaskMatch especifica o código de status de bitmask que é retornado pelo provedor de lista de permissões. Use esse parâmetro se o provedor de lista de permissões retornar respostas de bitmask. A entrada válida desse parâmetro é um endereço IP único no formato 127.0.0.1.
Propriedades do parâmetro
| Tipo: | IPAddress |
| 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
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 |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.
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 |
-Enabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Enabled especifica se a filtragem de conexão usa esse provedor de Lista de Permissões de IP. A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $true. Por padrão, a filtragem de conexão usa os novos provedores de Lista de Permissões de IP que você cria.
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-IPAddressesMatch
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro IPAddressesMatch especifica o endereço IP status códigos devolvidos pelo fornecedor de lista de permissões. Utilize este parâmetro se o fornecedor de lista de permissões devolver o endereço IP ou as respostas de registo A. Entrada válida para este parâmetro um ou mais endereços IP no formato 127.0.0.1. Pode introduzir vários endereços IP separados por vírgulas.
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 |
-LookupDomain
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro LookupDomain especifica o nome de host que deve usar o provedor de lista de permissões. A filtragem de conexão envia o endereço IP do servidor SMTP da conexão para o valor de nome de host especificado. Um valor de exemplo é allowlist.spamservice.com. O valor real a ser usado é fornecido pelo provedor de lista de permissões.
Propriedades do parâmetro
| Tipo: | SmtpDomain |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| 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
O parâmetro Name especifica um nome descritivo para o provedor de lista de Permissões de IP.
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
O parâmetro Priority especifica a ordem em que o agente de Filtragem de Conexão consultará os provedores de Lista de Permissões de IP que você configurou. Um valor de número inteiro mais baixo indica uma prioridade mais alta. Por padrão, sempre que um novo provedor de lista de Permissões de IP é adicionado, uma prioridade N+1 é atribuída à entrada, sendo que N é o número de provedores de lista de Permissões de IP que você configurou.
Se o parâmetro Priority for definido com um valor igual ao de outro provedor da lista de Permissões de IP, a prioridade do primeiro provedor da lista de Permissões de IP adicionado será aumentada em 1.
Propriedades do parâmetro
| Tipo: | Int32 |
| 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
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.