Set-AipServiceKeyProperties

語法

Set-AipServiceKeyProperties
   [-Force]
   -KeyIdentifier <String>
   -Active <Boolean>
   [-WhatIf]
   [-Confirm]
   [-RefreshSlcName]
   [<CommonParameters>]

Description

Set-AipServiceKeyProperties Cmdlet 會將租使用者指定之密鑰物件的封存狀態變更為作用中。 因為一次只能有一個作用中的租使用者密鑰，因此先前作用中的租使用者密鑰會自動設定為 [封存]。

Azure 資訊保護的新使用者會立即使用識別的租使用者密鑰來保護內容。 服務的現有用戶會逐漸從先前的作用中租使用者密鑰轉換至新作用中的租使用者密鑰，而這個錯開的轉換可能需要數周的時間才能完成。 您可以藉由重新初始化使用者環境（也稱為啟動載入）來強制更新用戶端。 使用先前使用中租使用者密鑰保護的檔和檔案，現在使用封存的租使用者密鑰，仍可供已授權的使用者存取。

將租使用者金鑰物件狀態設定為 [作用中] 也會使用新作用中的租使用者密鑰來重新簽署所有保護範本。 由於這可以是耗時的作業，特別是如果您有許多保護範本，因此不建議您經常執行此作業。

若要執行此 Cmdlet，您必須為要設定為 Active 的租使用者密鑰物件指定 KeyIdentifier。 若要取得此值，請使用 Get-AipServiceKeys Cmdlet。

除非您正從 AD RMS 進行移轉，否則請勿啟用 1024 位 RSA 金鑰，這被視為保護層級不足。 Microsoft不支援使用低金鑰長度，例如 1024 位 RSA 金鑰，以及提供不充分保護層級的通訊協議的相關使用，例如 SHA-1。 建議移至較高的金鑰長度。

如需租使用者金鑰的詳細資訊，請參閱 規劃和實作 Azure 資訊保護租使用者密鑰。

範例

範例 1：將租使用者密鑰物件的狀態變更為作用中

PS C:\> Set-AipServiceKeyProperties -Force -KeyIdentifier "c0f102b3-02cc-4816-b732-fcee73edd0e6" -Active $True

此命令會將租使用者密鑰物件的狀態從 Archived 變更為 Active。 KeyIdentifier 參數可識別要變更的租使用者密鑰物件，而且執行 get-AipServiceKeys即可 找到此值。 先前的狀態為 Active 的租使用者密鑰物件會自動設定為 [封存]。

因為命令會指定 Force 參數，因此命令不會提示您進行確認。

範例 2：重新整理 SLC 以反映租用戶易記名稱

PS C:\> Set-AipServiceKeyProperties -KeyIdentifier "c0f102b3-02cc-4816-b732-fcee73edd0e6" -RefreshSlcName

此命令會從 Azure Active Directory 擷取目前的租用戶易記名稱，並更新 SLC，讓使用者密鑰反映相同的名稱。

參數

-Active

-Confirm

-Force

-KeyIdentifier

-RefreshSlcName

-WhatIf

相關連結

• Get-AipServiceKeys