Get-MIPNetworkDiscoveryStatus

Relevant for: AIP unified labeling client only

Gets the current status of the Network Discovery service.

Syntax

Get-MIPNetworkDiscoveryStatus []

Description

The Get-MIPNetworkDiscoveryStatus cmdlet returns the current status of the Network Discovery service.

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.

Possible statuses include:

  • Offline: The service is not started.
  • Idle: The service is running but not currently scanning.
  • Scanning: The service is running and currently scanning the network.
  • Error: The service is running but it has encountered an error that prevents it from scanning files. For example, the service cannot access the database for the scanner configuration.

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: Service idle

PS C:\> Get-MIPNetworkDiscoveryStatus

NodeName                              Status           Jobs
--------                              -------------    -------------
msanchez-3384.emea.corp.contoso.com   Idle

This command gets the current status of the Network Discovery service.

The output shows that the Network Discovery scanner service is running, but not currently scanning.

Example 1: Service scanning

PS C:\> Get-MIPNetworkDiscoveryStatus

NodeName                              Status           Jobs
--------                              -------------    -------------
msanchez-3384.emea.corp.contoso.com   Scanning         39gsneaoz-d944-4fns-9b2f-ej6g350cd74

This command gets the current status of the Network Discovery service.

The output shows that the Network Discovery scanner service is currently running, and performing job ID 39gsneaoz-d944-4fns-9b2f-ej6g350cd74.

Inputs

None

Outputs

System.Object