Start-AIPScannerDiagnostics

  • Référence
Module:
AzureInformationProtection

Pertinent pour : Client d’étiquetage unifié uniquement

Démarre une série de vérifications d’intégrité pour un service de scanneur AIP installé localement.

Syntax

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

Description

L’applet de commande Start-AIPScannerDiagnostics déclenche une série de vérifications de diagnostic pour vérifier que le déploiement du scanneur est sain.

Les vérifications de diagnostic incluent si :

  • La base de données est à jour et accessible
  • Les URL sont accessibles
  • Un jeton d’authentification est trouvé et la stratégie peut être acquise
  • Le profil est défini dans le Portail Azure
  • La configuration hors connexion/en ligne existe et peut être acquise
  • Les règles sont valides

Exemples

Exemple 1 : démarre l’outil de diagnostic pour un scanneur AIP installé localement

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

Cet exemple vous invite à entrer des informations d’identification pour un compte spécifique, puis à fournir les informations d’identification du compte de service utilisé pour exécuter le service de scanneur AIP.

Exemple 2 : démarre l’outil de diagnostic avec un grand nombre d’erreurs imprimées à partir du journal du scanneur

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

Cet exemple vous invite à entrer des informations d’identification pour un compte spécifique, puis à fournir les informations d’identification du compte de service utilisé pour exécuter le service de scanneur AIP. Les 30 dernières erreurs sont imprimées à partir du journal du scanneur.

Paramètres

-OnBehalfOf

Définit le scanneur dans lequel vous souhaitez exécuter les diagnostics lorsque vous exécutez la commande sous un utilisateur qui n’est pas l’utilisateur du scanneur.

La valeur OnBehalfOf définit la variable qui contient un objet d’informations d’identification. Les vérifications de diagnostic sont exécutées sur le scanneur AIP pour le compte défini par cet objet d’informations d’identification.

Utilisez l’applet de commande Get-Credential pour obtenir la variable qui stocke vos informations d’identification.

Notes

Si vous exécutez la commande sous l’utilisateur du scanneur, ce paramètre n’est pas obligatoire.

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

-ResetConfig

Réinitialise le cache de stratégie. Lorsqu’elle est utilisée, la stratégie est actualisée même si la dernière actualisation s’est produite il y a moins de quatre heures.

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

-VerboseErrorCount

Pertinent uniquement lorsque le paramètre Verbose est utilisé dans la commande.

Définit le nombre d’erreurs que vous souhaitez voir imprimées à partir du journal du scanneur, si vous souhaitez imprimer un certain nombre d’erreurs autres que la valeur par défaut 10.

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

Sorties

System.Object

Notes

  • Cette applet de commande vous oblige à définir un compte de scanneur spécifique dans le paramètre -OnBehalfOf . Le paramètre OnBehalfOf vous oblige à exécuter votre session PowerShell en tant qu’administrateur.

  • Les vérifications de diagnostic vérifient les prérequis de déploiement du scanneur. Cette applet de commande est prise en charge uniquement après le déploiement du scanneur et la configuration de votre profil.

    Pour plus d’informations, consultez Déploiement du scanneur Azure Information Protection.