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.