Compartilhar via

Get-SweepRule

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Get-SweepRule para exibir regras de varredura em caixas de correio. As regras de varredura são executadas em intervalos regulares para ajudar a manter sua caixa de entrada limpa.

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

Syntax

Get-SweepRule
   [[-Identity] <SweepRuleIdParameter>]
   [-BypassScopeCheck]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Provider <String>]
   [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-SweepRule

Este exemplo retorna uma lista de resumo de todas as regras de varredura.

Exemplo 2

Get-SweepRule -Mailbox julia@contoso.com

Este exemplo retorna uma lista de resumo de todas as regras de varredura na caixa de correio especificada.

Exemplo 3

Get-SweepRule -Identity "x2hlsdpGmUifjFgxxGIOJw=="

Este exemplo retorna informações detalhadas para a regra Sweep com o valor de propriedade RuleId especificado.

Parâmetros

-BypassScopeCheck

A opção BypassScopeCheck especifica se deve ignorar a verificação de escopo do usuário que está executando o comando. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

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

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identidade especifica a regra De varredura que você deseja exibir. É possível usar qualquer valor que identifique a regra com exclusividade. Por exemplo:

  • Propriedade RuleId (por exemplo, x2hlsdpGmUifjFgxxGIOJw==).
  • Exchange Online: MailboxAlias\RuleID (por exemplo, rzaher\2hlsdpGmUifjFgxxGIOJw==).
  • Exchange local: MailboxCanonicalName\RuleID (por exemplo, contoso.com/Users/Rick Zaher\x2hlsdpGmUifjFgxxGIOJw==).
Type:SweepRuleIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Mailbox

O parâmetro Caixa de correio filtra os resultados pela caixa de correio especificada. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Provider

O parâmetro Provedor filtra os resultados pelo provedor especificado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection