Set-Authentication

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

Das Cmdlet Set-Authentication legt Anmeldeinformationen mithilfe eines Zugriffstokens fest, sodass Sie sich als anderer Benutzer anmelden und die Bezeichnungs-Cmdlets auch nicht interaktiv verwenden können.

Beispiel:

• Sie möchten den Microsoft Purview Information Protection-Scanner verwenden, um Dateien in mehreren Datenspeichern kontinuierlich zu ermitteln und automatisch zu bezeichnen und zu schützen.
• Sie möchten ein geplantes PowerShell-Skript ausführen, das Dateien auf einem Dateiserver mithilfe des Cmdlets Set-FileLabel automatisch bezeichnet und schützt.
• Sie verfügen über eine DLP-Lösung (Data Loss Prevention, Data Loss Prevention, die Sie durch automatisches Bezeichnen und Schützen von Dateien erweitern möchten, die von dieser Lösung identifiziert werden.

Ausführung mit oder ohne Parameter

Wenn Sie dieses Cmdlet ohne Parameter ausführen, erhält das Konto ein Microsoft Entra-Zugriffstoken, das 90 Tage lang oder bis zum Ablauf Ihres Kennworts gültig ist.

Um zu steuern, wann das Zugriffstoken abläuft, führen Sie dieses Cmdlet mit Parametern aus. Auf diese Weise können Sie das Zugriffstoken für 1 Jahr, 2 Jahre oder so konfigurieren, dass es nie abläuft. Für diese Konfiguration müssen eine oder mehrere Anwendungen in Microsoft Entra registriert sein.

Der Microsoft Purview Information Protection-Client unterstützt den OnBehalfOf-Parameter , der eine gespeicherte Variable akzeptiert, die den angegebenen Windows-Benutzernamen und das Kennwort enthält.

Verwenden Sie den Parameter DelegatedUser , um ein Benutzerkonto in Microsoft Entra anzugeben, dem eine oder mehrere Bezeichnungsrichtlinien aus Ihrem Management Center für Bezeichnungen zugewiesen sind.

PS C:\> Set-Authentication
Acquired access token

Dieser Befehl fordert Sie zur Eingabe Ihrer Microsoft Entra-Anmeldeinformationen auf, die zum Abrufen eines Zugriffstokens verwendet werden, das 90 Tage lang oder bis zum Ablauf Ihres Kennworts gültig ist.

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.

Führen Sie die Befehle in dieser PowerShell-Sitzung mit der Option Als Administrator ausführen aus, die für den OnBehalfOf-Parameter erforderlich ist.

Mit dem ersten Befehl wird ein PSCredential-Objekt erstellt und der angegebene Windows-Benutzername und das Kennwort in der Variablen $pscreds gespeichert. Wenn Sie diesen Befehl ausführen, werden Sie aufgefordert, das Kennwort für den von Ihnen angegebenen Benutzernamen einzugeben.

Der zweite Befehl ruft ein Zugriffstoken ab, das mit der Anwendung kombiniert wird, sodass das Token je nach Konfiguration der registrierten App in Microsoft Entra 1 Jahr oder 2 Jahre gültig wird oder nie abläuft Der Benutzername von scanner@contoso.com legt den Benutzerkontext für das Herunterladen von Bezeichnungen und Bezeichnungsrichtlinien aus dem Azure Purview-Portal oder dem Microsoft Purview-Complianceportal fest.