Set-AipServiceKeyProperties

Syntaxe

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

Description

L’applet de commande Set-AipServiceKeyProperties modifie l’état Archivé d’un objet clé spécifié pour que le locataire soit actif. Étant donné qu’il ne peut y avoir qu’une seule clé de locataire active à tout moment, la clé de locataire précédemment active est automatiquement définie sur Archiver.

Les nouveaux utilisateurs d’Azure Information Protection utilisent immédiatement la clé de locataire identifiée pour protéger le contenu. Les utilisateurs existants du service passent progressivement de la clé de locataire précédemment active à la clé de locataire nouvellement active, et cette transition échelonnée peut prendre quelques semaines. Vous pouvez forcer la mise à jour sur les clients en réin initialisant l’environnement utilisateur (également appelé démarrage). Les documents et les fichiers protégés avec la clé de locataire précédemment active restent accessibles aux utilisateurs autorisés à l’aide de la clé de locataire qui est désormais archivée.

La définition de l’état de l’objet de clé de locataire sur Active démissionne également tous les modèles de protection avec la clé de locataire nouvellement active. Étant donné qu’il peut s’agir d’une opération fastidieuse, en particulier si vous avez de nombreux modèles de protection, nous vous déconseillons d’exécuter cette opération fréquemment.

Pour exécuter cette applet de commande, vous devez spécifier keyIdentifier pour l’objet de clé de locataire que vous souhaitez définir sur Active. Pour obtenir cette valeur, utilisez l’applet de commande Get-AipServiceKeys .

Sauf si vous êtes au milieu d’une migration à partir d’AD RMS, n’activez pas de clé RSA 1024 bits, qui est considérée comme un niveau de protection insuffisant. Microsoft n’approuve pas l’utilisation de longueurs de clés inférieures telles que les clés RSA 1024 bits et l’utilisation associée de protocoles qui offrent des niveaux de protection insuffisants, tels que SHA-1. Nous vous recommandons de passer à une longueur de clé plus élevée.

Pour plus d’informations sur la clé de locataire, consultez Planification et implémentation de votre clé de locataire Azure Information Protection.

Exemples

Exemple 1 : Modifier l’état d’un objet de clé de locataire pour qu’il soit actif

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

Cette commande modifie l’état d’un objet de clé de locataire d’Archived en Actif. Le paramètre KeyIdentifier identifie l’objet de clé de locataire à modifier, et cette valeur est disponible en exécutant Get-AipServiceKeys. L’objet de clé de locataire qui avait précédemment l’état Actif est automatiquement défini sur Archiver.

Étant donné que la commande spécifie le paramètre Force , la commande ne vous invite pas à confirmer.

Paramètres

-Active

-Confirm

-Force

-KeyIdentifier

-WhatIf

Liens associés

• Get-AipServiceKeys