Set-Authentication

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

Set-Authentication cmdlet 使用訪問令牌設置憑據，以便您可以以其他使用者身份登錄，還可以以非交互方式使用標記 cmdlet。

例如：

• 您希望使用 Microsoft Purview 資訊保護掃描程式持續發現並自動標記和保護多個資料儲存中的檔。
• 您希望運行一個計劃的PowerShell腳本，該腳本使用 Set-FileLabel cmdlet 自動標記和保護文件伺服器上的檔。
• 您有一個數據丟失防護 （DLP） 解決方案，您希望通過自動標記和保護此解決方案識別的檔來增強該解決方案。

帶參數或不帶參數運行

如果在不帶參數的情況下運行此 cmdlet，則帳戶將獲取有效期為 90 天或直到您的密碼過期的 Microsoft Entra 訪問令牌。

要控制訪問令牌的過期時間，請使用參數運行此 cmdlet。 這允許您將訪問令牌配置為1年、2年或永不過期。 此配置要求您在 Microsoft Entra 中註冊一個或多個應用程式。

Microsoft Purview 資訊保護用戶端支援 OnBehalfOf 參數，該參數接受包含指定 Windows 使用者名和密碼的存儲變數。

使用 DelegatedUser 參數指定 Microsoft Entra 中的使用者帳戶，該帳戶從標籤管理中心分配了一個或多個標籤策略。

PS C:\> Set-Authentication
Acquired access token

此命令會提示您輸入 Microsoft Entra 憑據，這些憑據用於獲取有效期為 90 天或直到您的密碼過期的訪問令牌。

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.

使用 OnBehalfOf 參數所需的 Run as Administrator 選項運行此 PowerShell 會話中的命令。

第一個命令創建一個 PSCredential 物件，並將指定的 Windows 使用者名和密碼存儲在 $pscreds 變數中。 當您執行此命令時，系統會提示您輸入您指定之使用者名稱的密碼。

第二個命令獲取與應用程式組合的訪問令牌，以便根據您在 Microsoft Entra 中註冊的應用程式的配置，該令牌的有效期為 1 年、2 年或永不過期。 的使用者名 scanner@contoso.com 將使用者上下文設置為從 Microsoft Purview 門戶或Microsoft Purview 合規門戶下載標籤和標籤策略。