Get-ExoSecOpsOverrideRule

This cmdlet is available only in the cloud-based service.

Use the Get-ExoSecOpsOverrideRule cmdlet to view SecOps mailbox override rules to bypass Exchange Online Protection filtering. For more information, see Configure the advanced delivery policy for third-party phishing simulations and email delivery to SecOps mailboxes.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

Syntax

Get-ExoSecOpsOverrideRule
   [[-Identity] <ComplianceRuleIdParameter>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Policy <PolicyIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Description

You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.

Examples

Example 1

Get-ExoSecOpsOverrideRule

This example returns detailed information about the SecOps mailbox override rule (there should be only one).

Example 2

Get-ExoSecOpsOverrideRule | Format-Table Name,Mode

This example identifies the valid rule (one) and any invalid rules.

Although the previous command should return only one rule, a rule that's pending deletion might also be included in the results.

Parameters

-Confirm

This parameter is reserved for internal Microsoft use.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DomainController

This parameter is reserved for internal Microsoft use.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

The Identity parameter specifies the SecOps override rule that you want to view. You can use any value that uniquely identifies the rule. For example:

  • Name
  • Id
  • Distinguished name (DN)
  • GUID

The name of the rule uses the following syntax: _Exe:SecOpsOverrid:<GUID\> [sic] where <GUID> is a unique GUID value (for example, 312c23cf-0377-4162-b93d-6548a9977efb).

Type:ComplianceRuleIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Policy

The Policy parameter filters the results by SecOps mailbox override policy. You can use any value that uniquely identifies the policy. For example:

  • Name
  • Id
  • Distinguished name (DN)
  • GUID
Type:PolicyIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

This parameter is reserved for internal Microsoft use.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online