Share via

New-MDIConfigurationReport

Module:
DefenderForIdentity Module

Generates a report of MDI ___domain configuration and saves it as an HTML and a detailed JSON file.

Syntax

Default (Default) 

New-MDIConfigurationReport
    [-Path] <String>
    [-Mode <String>]
    [-GpoNamePrefix <String>]
    [-OpenHtmlReport]
    [<CommonParameters>]

Description

Generates a report of MDI ___domain configuration and saves it as HTML file and detailed JSON files. The report validates the ___domain SACLs and the presence of the MDI related configuration GPOs. The HTML report includes a table with the status for each configuration and a link to the detailed JSON data.

Examples

EXAMPLE 1

New-MDIConfigurationReport -Path "C:\Reports" -OpenHtmlReport

This example generates a report of MDI ___domain configuration, saves it as HTML and JSON files in the C:\Reports directory, and opens the HTML report after in your default browser.

Parameters

-Domain

Specifies the name of the ___domain to run the command against. This parameter is optional and defaults to the user's DNS ___domain.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GpoNamePrefix

Specifies a prefix for the Group Policy Objects (GPO) names to be searched. Use this parameter for GPO naming convention.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Identity

Specifies the name of the service account used for the EntraConnectAuditing or RemoteSAM configuration. This parameter is mandatory in the Domain mode.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Mode

Specifies the mode to use. You must specify one of the following values:

  • Domain: Collect settings from the Group Policy objects
  • LocalMachine: Collect settings from the local machine

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OpenHtmlReport

If specified, opens the HTML report after it's generated.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Path

Specifies the directory where to save the HTML and JSON report files.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.