Set-Authentication

Set-Authentication
    [-AppId <Guid>]
    [-AppSecret <String>]
    [-TenantId <String>]
    [-DelegatedUser <String>]
    [-OnBehalfOf <PSCredential>]

L’applet de commande Set-Authentication définit les informations d’identification à l’aide d’un jeton d’accès afin que vous puissiez vous connecter en tant qu’utilisateur différent et utiliser les applets de commande d’étiquetage de manière non interactive.

Par exemple:

• Vous souhaitez utiliser l’analyseur Microsoft Purview Information Protection pour découvrir en permanence, étiqueter et protéger automatiquement des fichiers dans plusieurs banques de données.
• Vous souhaitez exécuter un script PowerShell planifié qui étiquette et protège automatiquement les fichiers sur un serveur de fichiers à l’aide de l’applet de commande Set-FileLabel .
• Vous disposez d’une solution de prévention des pertes de données (DLP) que vous souhaitez compléter en étiquetant et en protégeant automatiquement les fichiers identifiés par cette solution.

Exécution avec ou sans paramètres

Si vous exécutez cette applet de commande sans paramètres, le compte acquiert un jeton d’accès Microsoft Entra valide pendant 90 jours ou jusqu’à l’expiration de votre mot de passe.

Pour contrôler l’expiration du jeton d’accès, exécutez cette applet de commande avec des paramètres. Cela vous permet de configurer le jeton d’accès pour 1 an, 2 ans ou pour qu’il n’expire jamais. Cette configuration nécessite qu’une ou plusieurs applications soient enregistrées dans Microsoft Entra.

Le client Microsoft Purview Information Protection prend en charge le paramètre OnBehalfOf , qui accepte une variable stockée contenant le nom d’utilisateur et le mot de passe Windows que vous avez spécifiés.

Utilisez le paramètre DelegatedUser pour spécifier un compte d’utilisateur dans Microsoft Entra auquel est attribuée une ou plusieurs stratégies d’étiquette à partir de votre centre de gestion de l’étiquetage.

PS C:\> Set-Authentication
Acquired access token

Cette commande vous invite à entrer vos informations d’identification Microsoft Entra qui sont utilisées pour acquérir un jeton d’accès valide pendant 90 jours ou jusqu’à l’expiration de votre mot de passe.

PS C:\>$pscreds = Get-Credential CONTOSO\scanner
PS C:\> Set-Authentication -AppId "77c3c1c3-abf9-404e-8b2b-4652836c8c66" -AppSecret "OAkk+rnuYc/u+]ah2kNxVbtrDGbS47L4" -DelegatedUser scanner@contoso.com -TenantId "9c11c87a-ac8b-46a3-8d5c-f4d0b72ee29a" -OnBehalfOf $pscreds
Acquired application access token on behalf of CONTOSO\scanner.

Exécutez les commandes dans cette session PowerShell avec l’option Exécuter en tant qu’administrateur , qui est requise pour le paramètre OnBehalfOf .

La première commande crée un objet PSCredential et stocke le nom d’utilisateur et le mot de passe Windows spécifiés dans la variable $pscreds . Lorsque vous exécutez cette commande, vous êtes invité à entrer le mot de passe du nom d’utilisateur que vous avez spécifié.

La deuxième commande acquiert un jeton d’accès qui est combiné à l’application afin que le jeton devienne valide pendant 1 an, 2 ans ou n’expire jamais, en fonction de votre configuration de l’application inscrite dans Microsoft Entra . Le nom d’utilisateur de scanner@contoso.com définit le contexte utilisateur pour télécharger les étiquettes et les stratégies d’étiquette à partir du portail Microsoft Purview ou du portail de conformité Microsoft Purview.