Set-Authentication

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

Polecenie cmdlet Set-Authentication ustawia poświadczenia przy użyciu tokenu dostępu, dzięki czemu można zalogować się jako inny użytkownik, a także używać poleceń cmdlet etykietowania w sposób nieinteraktywny.

Przykład:

• Chcesz używać skanera Microsoft Purview Information Protection do ciągłego odnajdywania i automatycznego etykietowania i ochrony plików w wielu magazynach danych.
• Chcesz uruchomić zaplanowany skrypt programu PowerShell, który automatycznie etykietuje i chroni pliki na serwerze plików przy użyciu polecenia cmdlet Set-FileLabel .
• Masz rozwiązanie do ochrony przed utratą danych (DLP), które chcesz rozszerzyć, automatycznie etykietując i chroniąc pliki identyfikowane przez to rozwiązanie.

Uruchamianie z parametrami lub bez nich

Jeśli uruchomisz to polecenie cmdlet bez parametrów, konto uzyska token dostępu Microsoft Entra, który jest ważny przez 90 dni lub do momentu wygaśnięcia hasła.

Aby kontrolować, kiedy token dostępu wygasa, uruchom to polecenie cmdlet z parametrami. Dzięki temu token dostępu można skonfigurować na 1 rok, 2 lata lub nigdy nie wygaśnie. Ta konfiguracja wymaga zarejestrowania co najmniej jednej aplikacji w programie Microsoft Entra.

Klient usługi Microsoft Purview Information Protection obsługuje parametr OnBehalfOf , który akceptuje przechowywaną zmienną zawierającą określoną nazwę użytkownika i hasło systemu Windows.

Użyj parametru DelegatedUser , aby określić konto użytkownika w usłudze Microsoft Entra, do którego przypisano co najmniej jedną zasadę etykiet z centrum zarządzania etykietami.

PS C:\> Set-Authentication
Acquired access token

To polecenie monituje o podanie poświadczeń Microsoft Entra, które są używane do uzyskiwania tokenu dostępu, który jest ważny przez 90 dni lub do momentu wygaśnięcia hasła.

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.

Uruchom polecenia w tej sesji programu PowerShell z opcją Uruchom jako administrator , która jest wymagana dla parametru OnBehalfOf .

Pierwsze polecenie tworzy obiekt PSCredential i zapisuje określoną nazwę użytkownika i hasło systemu Windows w zmiennej $pscreds . Po uruchomieniu tego polecenia zostanie wyświetlony monit o podanie hasła dla określonej nazwy użytkownika.

Drugie polecenie uzyskuje token dostępu, który jest połączony z aplikacją, dzięki czemu token staje się ważny przez 1 rok, 2 lata lub nigdy nie wygasa, zgodnie z konfiguracją zarejestrowanej aplikacji w programie Microsoft Entra . Nazwa użytkownika ustawia scanner@contoso.com kontekst użytkownika w celu pobrania etykiet i zasad etykiet z portalu Microsoft Purview lub portal zgodności Microsoft Purview.