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