Start-AIPScannerDiagnostics

  • Referens
Modul:
AzureInformationProtection

Relevant för: Endast klient för enhetlig etikettering

Startar en serie hälsokontroller för en lokalt installerad AIP-skannertjänst.

Syntax

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

Description

Cmdleten Start-AIPScannerDiagnostics utlöser en serie diagnostikkontroller för att kontrollera att skannerdistributionen är felfri.

Diagnostiska kontroller omfattar om:

  • Databasen är uppdaterad och tillgänglig
  • URL:er är tillgängliga
  • En autentiseringstoken hittas och principen kan hämtas
  • Profilen anges i Azure Portal
  • Offline-/onlinekonfiguration finns och kan hämtas
  • Reglerna är giltiga

Exempel

Exempel 1: Startar diagnostikverktyget för en lokalt installerad AIP-skanner

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

I det här exemplet uppmanas du att ange autentiseringsuppgifter för ett visst konto och sedan ange autentiseringsuppgifterna för tjänstkontot som används för att köra AIP-skannertjänsten.

Exempel 2: Startar diagnostikverktyget med ett stort antal fel som skrivs ut från skannerloggen

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

I det här exemplet uppmanas du att ange autentiseringsuppgifter för ett visst konto och sedan ange autentiseringsuppgifterna för tjänstkontot som används för att köra AIP-skannertjänsten. De senaste 30 felen skrivs ut från skannerloggen.

Parametrar

-OnBehalfOf

Definierar den skanner där du vill köra diagnostiken när du kör kommandot under en användare som inte är skanneranvändaren.

Värdet OnBehalfOf definierar variabeln som innehåller ett autentiseringsobjekt. Diagnostikkontrollerna körs på AIP-skannern för kontot som definierats av objektet med autentiseringsuppgifter.

Använd cmdleten Get-Credential för att hämta variabeln som lagrar dina autentiseringsuppgifter.

Anteckning

Om du kör kommandot under skanneranvändaren krävs inte den här parametern.

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

-ResetConfig

Återställer principcachen. När den används uppdateras principen även om den senaste uppdateringen inträffade för mindre än fyra timmar sedan.

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

-VerboseErrorCount

Relevant endast när parametern Verbose används i kommandot .

Definierar antalet fel som du vill se utskrivna från skannerloggen, om du vill skriva ut ett antal andra fel än standardvärdet 10.

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

Utdata

System.Object

Kommentarer

  • Den här cmdleten kräver att du definierar ett specifikt skannerkonto i parametern -OnBehalfOf . Parametern OnBehalfOf kräver att du kör PowerShell-sessionen som administratör.

  • Diagnostikkontroller kontrollerar kraven för skannerdistribution. Den här cmdleten stöds endast när du har distribuerat skannern och din profil har konfigurerats.

    Mer information finns i Distribuera Azure Information Protection-skannern.