Import-MIPNetworkDiscoveryConfiguration

Reference

Module:: AzureInformationProtection

Relevant for: AIP unified labeling client only

Imports a local configuration for Network Discovery network scan jobs.

Syntax

Import-MIPNetworkDiscoveryConfiguration
      -FileName <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Import-MIPNetworkDiscoveryConfiguration cmdlet imports local configuration settings for the Azure Information Protection network scan jobs, and automatically configures the scanner to use the offline configuration.

Network Discovery network scan jobs enable Azure Information Protection administrators to scan specific IP addresses or ranges for risky repositories to add to scan further with content scan jobs.

Use this cmdlet only after you have configured a cluster and a network scan job in the Azure portal, and exported those settings to a file.
If you need to make configuration changes to the network scan jobs after you have run this cmdlet, make those changes in the Azure portal, export the network scan job again, and rerun this cmdlet.

If you want to change the scanner to use the online configuration directly after you have run this cmdlet, use the Set-MIPNetworkDiscoveryConfiguration and set the OnlineConfiguration parameter to On.

Any changes will be used the next time the scanner runs. If you need the changes to take effect immediately, restart the Azure Information Protection Scanner service on the Windows server computer.

Note

The Azure Information Protection (AIP) network discovery feature uses AIP analytics (public preview). As of March 18, 2022, we are sunsetting network discovery together with the AIP analytics and audit logs public preview. Moving forward, we'll be using the Microsoft 365 auditing solution. Full retirement for network discovery, AIP analytics, and audit logs is scheduled for September 30, 2022.

For more information, see Removed and retired services.

Examples

Example 1: Import a locally configured Azure Information Protection network scan job

PS C:\> Import-MIPNetworkDiscoveryConfiguration -FileName "C:/configuration.json"

Configuration was imported successfully.

In this example, the scanner is configured to prevent getting network scan job settings directly from the Azure portal. Instead, the network scan job is imported from a file named C:/configuration.json.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-FileName

Specifies a file that contains network scan job configuration settings. To create this file, export your network scan job from the Azure portal.

The file is used to do a one-time import of network scan job settings into the scanner configuration database.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

None

Outputs

System.Object