Set-AipServiceKeyProperties

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

Set-AipServiceKeyProperties コマンドレットは、テナントの指定したキー オブジェクトのアーカイブ済み状態をアクティブに変更します。 アクティブなテナント キーは一度に 1 つだけ存在できるため、以前にアクティブだったテナント キーは自動的に [アーカイブ済み] に設定されます。

Azure Information Protection の新しいユーザーは、識別されたテナント キーをすぐに使用してコンテンツを保護します。 サービスの既存のユーザーは、以前にアクティブだったテナント キーから新しくアクティブなテナント キーに徐々に移行します。この移行が完了するまでに数週間かかる場合があります。 ユーザー環境 (ブートストラップとも呼ばれます) を再初期化することで、クライアントで強制的に更新を行うことができます。 以前にアクティブなテナント キーで保護されたドキュメントとファイルは、現在アーカイブされているテナント キーを使用して、承認されたユーザーから引き続きアクセスできます。

テナント キー オブジェクトの状態を [アクティブ] に設定すると、新しくアクティブなテナント キーを持つすべての保護テンプレートも再署名されます。 これは時間のかかる操作になる可能性があるため、特に多くの保護テンプレートがある場合は、この操作を頻繁に実行しないことをお勧めします。

このコマンドレットを実行するには、Active に設定するテナント キー オブジェクトの KeyIdentifier を指定する必要があります。 この値を取得するには、Get-AipServiceKeys コマンドレットを使用します。

AD RMS からの移行中でない限り、不適切なレベルの保護と見なされる 1024 ビット RSA キーをアクティブ化しないでください。 Microsoft は、1024 ビット RSA キーなどの下位のキー長の使用と、SHA-1 などの不適切なレベルの保護を提供するプロトコルの関連する使用を保証していません。 キーの長さを大きくすることをお勧めします。

テナント キーの詳細については、「Azure Information Protection テナント キーの計画と実装」を参照してください。

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

このコマンドは、テナント キー オブジェクトの状態を Archived から Active に変更します。 KeyIdentifier パラメーターは、変更するテナント キー オブジェクトを識別します。この値は、Get-AipServiceKeys実行することで確認できます。 以前に状態が Active のテナント キー オブジェクトは、自動的に [アーカイブ済みに設定されます。

コマンドは Force パラメーターを指定するため、確認を求めるメッセージは表示されません。

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

このコマンドは、Azure Active Directory から現在のテナントフレンドリ名を取得し、ユーザー キーに同じ名前が反映されるように SLC を更新します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。