Share via


Set-MIPNetworkDiscoveryConfiguration

Relevant for: AIP unified labeling client only

Sets optional configurations for the Network Discovery service.

Syntax

Set-MIPNetworkDiscoveryConfiguration
   [-OnlineConfiguration <OnlineConfiguration>]
   [<CommonParameters>]

Description

The Set-MIPNetworkDiscoveryConfiguration cmdlet sets local configuration settings for the Network Discovery service.

The Network Discovery service manages network scan jobs, and enables Azure Information Protection administrators to scan specific IP addresses or ranges for risky repositories. Administrators may want to add these repositories to content scan jobs and scan their content further.

While most of the network scan job settings are configured in the Azure portal, you must use this cmdlet if you need to import configuration settings from a file because the deployment cannot support online configuration.

Any changes will be used the next time the network scan jobs run. If you need the changes to take effect immediately, restart the Network Discovery 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: Set the Network Discovery service to use online configuration

powershell
PS C:\> Set-AIPScannerConfiguration -OnlineConfiguration On

Configuration was set successfully.

This command sets the Network Discovery service to get its configuration directly from the settings configured online in the Azure portal.

Parameters

-OnlineConfiguration

Specifies whether the scanner gets its configuration settings directly from the Azure portal, or uses an offline configuration file.

  • On: The default setting. The scanner gets its configuration settings directly from the Azure portal.

  • Off: The Network Discovery service is prevented from getting its configuration settings directly from the Azure portal. Instead, the scanner is configured by settings that you import from a file.

If the scanner cannot support online configuration, you must still configure the network scan jobs in the Azure portal. Then, export the network scan job configuration from the portal to a .json file and import this file by using the Import-Import-MIPNetworkDiscoveryConfiguration cmdlet.

Type:OnlineConfiguration
Accepted values:On, Off
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object