Set-AIPAuthentication

  • Odwołanie
Moduł:
AzureInformationProtection

Ustawia poświadczenia uwierzytelniania klienta usługi Azure Information Protection.

Składnia

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

Opis

Polecenie cmdlet Set-AIPAuthentication ustawia poświadczenia przy użyciu tokenu dostępu, aby można było zalogować się jako inny użytkownik, a także użyć poleceń cmdlet etykietowania nieinterakcyjnych.

Na przykład:

  • Chcesz używać skanera usługi Azure 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 poleceń cmdlet Set-AIPFileClassification lub Set-AIPFileLabel .
  • Masz rozwiązanie ochrony przed utratą danych (DLP), które ma zostać rozszerzone przez automatyczne etykietowanie i ochronę plików zidentyfikowanych przez to rozwiązanie.

Uruchamianie z parametrami lub bez

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

Aby kontrolować moment wygaśnięcia ważności tokenu dostępu, uruchom to polecenie cmdlet z parametrami. Pozwala to skonfigurować token dostępu przez 1 rok, 2 lata lub nigdy nie wygasać. Ta konfiguracja wymaga zarejestrowania co najmniej jednej aplikacji w usłudze Azure Active Directory.

Aby uzyskać więcej informacji, zobacz etykietowanie plików nieinterakcyjnych dla klienta ujednoliconego etykietowania usługi AIP.

Ujednolicony klient etykietowania obsługuje parametr OnBehalfOf , który akceptuje zmienną przechowywaną zawierającą określoną nazwę użytkownika systemu Windows i hasło.

Użyj parametru DelegatedUser , aby określić konto użytkownika w usłudze Azure Active Directory, które jest przypisane do co najmniej jednej zasady etykiety z centrum zarządzania etykietami.

Przykłady

Przykład 1. Ustawianie poświadczeń uwierzytelniania bez używania aplikacji zarejestrowanych w usłudze Azure Active Directory

PS C:\> Set-AIPAuthentication 
Acquired access token

To polecenie wyświetla monit o poświadczenia Azure AD używane do uzyskania tokenu dostępu ważnego przez 90 dni lub do momentu wygaśnięcia hasła.

Przykład 2: (tylko ujednolicony klient etykietowania) Ustawianie poświadczeń uwierzytelniania przy użyciu aplikacji zarejestrowanej w usłudze Azure Active Directory

PS C:\>$pscreds = Get-Credential CONTOSO\scanner
PS C:\> Set-AIPAuthentication -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 przechowuje określoną nazwę użytkownika systemu Windows i hasło 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ą, aby token stał się ważny przez 1 rok, 2 lata lub nigdy nie wygasa zgodnie z konfiguracją zarejestrowanej aplikacji w Azure AD. Nazwa scanner@contoso.com użytkownika ustawia kontekst użytkownika na pobieranie etykiet i zasad etykiet z centrum zarządzania etykietami, takich jak centrum zarządzania Office 365 Security & Compliance Center.

Parametry

-AppId

Istotne dla: Tylko klient ujednoliconego etykietowania usługi AIP

Określa "Identyfikator aplikacji (klienta) dla aplikacji zarejestrowanej w Azure AD.

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

-AppSecret

Istotne dla: Tylko klient ujednoliconego etykietowania usługi AIP

Określa wartość klucza tajnego klienta wygenerowaną w momencie zarejestrowania aplikacji w Azure AD.

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

-DelegatedUser

Istotne dla: Tylko klient ujednoliconego etykietowania usługi AIP

Określa poświadczenia konta użytkownika do użycia podczas pobierania zasad etykiet z etykietami poufności z centrum zarządzania etykietami etykiet.

  • Używane poświadczenia muszą być kontem usługi Azure Active Directory, które może służyć do uzyskiwania zasad i konfiguracji online.

    • Może to być to samo konto, które jest używane dla obiektu ServiceUserCredentials , jeśli to konto jest synchronizowane z usługą Azure Active Directory lub innym kontem.

    • Jeśli to konto musi ponownie chronić pliki, usunąć ochronę z plików lub sprawdzić chronione pliki, utwórz go jako administratora usługi Azure Information Protection.

  • Ustaw wartość tego parametru przy użyciu nazwy UPN. Na przykład: scannerservice@contoso.com

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

-OnBehalfOf

Istotne dla: Tylko klient ujednoliconego etykietowania usługi AIP

Określa zmienną, która zawiera obiekt poświadczeń używany przez klienta ujednoliconego etykietowania usługi AIP.

Ten parametr jest używany, gdy nie można udzielić praw logowania do zaplanowanych poleceń programu PowerShell.

  • Użyj tych samych poświadczeń dla tego parametru, jak użyto do uruchomienia skanera zdefiniowanego przez parametr ServiceUserCredentials .

  • Aby użyć tego parametru, należy uruchomić sesję programu PowerShell z opcją Uruchom jako administrator .

Użyj polecenia cmdlet Get-Credential , aby utworzyć zmienną, która przechowuje poświadczenia. Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Cmdlet.

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

-TenantId

Istotne dla: Tylko klient ujednoliconego etykietowania usługi AIP

Określa identyfikator GUID dzierżawy zawierający zarejestrowaną aplikację w Azure AD.

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

Dane wejściowe

None

Dane wyjściowe

System.Object