Delen via

Start-AIPScannerDiagnostics

  • Referentie
Module:
AzureInformationProtection

Relevant voor: Alleen geïntegreerde labelclient

Hiermee start u een reeks statuscontroles voor een lokaal geïnstalleerde AIP-scannerservice.

Syntaxis

Start-AIPScannerDiagnostics
     [-OnBehalfOf <PSCredential>]
     [-ResetConfig]
     [-VerboseErrorCount <integer>]
     [<CommonParameters>]

Description

De cmdlet Start-AIPScannerDiagnostics activeert een reeks diagnostische controles om te controleren of de implementatie van de scanner in orde is.

Diagnostische controles omvatten of:

  • De database is up-to-date en toegankelijk
  • URL's zijn toegankelijk
  • Er wordt een verificatietoken gevonden en het beleid kan worden verkregen
  • Het profiel is ingesteld in de Azure Portal
  • Offline-/onlineconfiguratie bestaat en kan worden verkregen
  • Regels zijn geldig

Voorbeelden

Voorbeeld 1: Het diagnostische hulpprogramma voor een lokaal geïnstalleerde AIP-scanner starten

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> Start-AIPScannerDiagnostics -onbehalf $scanner_account_creds

In dit voorbeeld wordt u gevraagd om referenties voor een specifiek account in te voeren en vervolgens de referenties op te geven van het serviceaccount dat wordt gebruikt om de AIP-scannerservice uit te voeren.

Voorbeeld 2: het diagnostische hulpprogramma starten met een groot aantal fouten dat wordt afgedrukt vanuit het scannerlogboek

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> Start-AIPScannerDiagnostics -onbehalf $scanner_account_creds -Verbose -VerboseErrorCount 30

In dit voorbeeld wordt u gevraagd om referenties voor een specifiek account in te voeren en vervolgens de referenties op te geven van het serviceaccount dat wordt gebruikt om de AIP-scannerservice uit te voeren. De laatste 30 fouten worden afgedrukt in het scannerlogboek.

Parameters

-OnBehalfOf

Definieert de scanner waar u de diagnostische gegevens wilt uitvoeren wanneer u de opdracht uitvoert onder een gebruiker die niet de scannergebruiker is.

De waarde OnBehalfOf definieert de variabele die een referentieobject bevat. De diagnostische controles worden uitgevoerd op de AIP-scanner voor het account dat is gedefinieerd door dat referentieobject.

Gebruik de cmdlet Get-Credential om de variabele op te halen waarin uw referenties worden opgeslagen.

Notitie

Als u de opdracht onder de scannergebruiker uitvoert, is deze parameter niet vereist.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResetConfig

Hiermee wordt de beleidscache opnieuw ingesteld. Bij gebruik wordt het beleid vernieuwd, zelfs als de laatste vernieuwing minder dan vier uur geleden is opgetreden.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VerboseErrorCount

Alleen relevant wanneer de uitgebreide parameter wordt gebruikt in de opdracht.

Hiermee definieert u het aantal fouten dat u wilt weergeven in het scannerlogboek, als u een aantal andere fouten wilt afdrukken dan de standaardwaarde 10.

Type:Integer
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

System.Object

Notities

  • Voor deze cmdlet moet u een specifiek scanneraccount definiëren in de parameter -OnBehalfOf . Voor de parameter OnBehalfOf moet u uw PowerShell-sessie uitvoeren als beheerder.

  • Diagnostische controles controleren wel op vereisten voor scannerimplementatie. Deze cmdlet wordt alleen ondersteund nadat u de scanner hebt geïmplementeerd en uw profiel hebt geconfigureerd.

    Zie De Azure Information Protection-scanner implementeren voor meer informatie.