Get-TransportRule
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 Get-TransportRule para ver as regras de transporte (regras de fluxo de correio) na sua organização.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-TransportRule
[[-Identity] <RuleIdParameter>]
[-DomainController <Fqdn>]
[-State <RuleState>]
[-DlpPolicy <String>]
[-ExcludeConditionActionDetails <Boolean>]
[-Filter <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Nos servidores da Caixa de Correio, este cmdlet devolve todas as regras na organização do Exchange que estão armazenadas no Active Directory. Num servidor de Transporte edge, este cmdlet só devolve regras configuradas no servidor local.
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
Get-TransportRule
Este exemplo devolve uma lista de resumo de todas as regras na sua organização.
Exemplo 2
Get-TransportRule "Ethical Wall - Sales and Brokerage Departments" | Format-List
Este exemplo devolve informações detalhadas para a regra denominada "Muro Ético – Departamentos de Vendas e Corretagem".
Para obter mais informações sobre pipelining, veja About Pipelines (Acerca dos Pipelines). Para obter mais informações sobre como trabalhar com a saída de um comando, consulte Trabalhar com a saída do comando.
Exemplo 3
Get-TransportRule -DlpPolicy "PII (U.S.)"
No Exchange no local, este exemplo devolve uma lista de resumo das regras que impõem a política DLP denominada PII (E.U.A.) na organização.
Exemplo 4
Get-TransportRule | Where {$_.DlpPolicy -ne $null}
No Exchange no local, este exemplo devolve uma lista de resumo de todas as regras que impõem políticas DLP na organização.
Parâmetros
-DlpPolicy
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Nota: este parâmetro está funcional apenas no Exchange no local.
O parâmetro DlpPolicy filtra os resultados pelo nome da política de prevenção de perda de dados (DLP) especificada. Se o valor contiver espaços, coloque-o entre aspas (").
As políticas DLP em sua organização permitem que você evite que informações confidenciais sejam divulgadas acidentalmente. Cada política DLP é imposta usando-se um conjunto de regras de transporte.
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 |
-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.
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 |
-ExcludeConditionActionDetails
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro ExcludeConditionActionDetails especifica se pretende ocultar detalhes específicos dos resultados. Os valores válidos são:
- $true: as propriedades Descrição, Condições e Ações, bem como quaisquer valores de propriedade de condição, exceção e ação configurados estão em branco.
- $false: não existem propriedades ou valores de propriedade ocultos. Este valor é a predefinição.
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 |
-Filter
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Filter filtra os resultados com um OPATH. Esse parâmetro pesquisa a propriedade Description, que inclui as condições, as exceções, as ações e os valores associados de uma regra de transporte.
Esse parâmetro usa a sintaxe "Description -like 'Text*'". Por exemplo, "Description -like '192.168.1.1*'".
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 |
-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 regra que pretende ver. É possível usar qualquer valor que identifique a regra com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | RuleIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-ResultSize
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
Propriedades do parâmetro
| Tipo: | Unlimited |
| 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 |
-State
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 State especifica que filtra os resultados por regras ativadas ou desativadas. Os valores válidos são:
- Ativado: apenas as regras ativadas são devolvidas nos resultados.
- Desativado: apenas as regras desativadas são devolvidas nos resultados.
Se você não usar esse parâmetro, o comando retorna todas as regras, tanto habilitadas quanto desabilitadas.
Propriedades do parâmetro
| Tipo: | RuleState |
| 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 |
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.