Set-AipServiceKeyProperties

Sintassi

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

Descrizione

Il cmdlet Set-AipServiceKeyProperties modifica lo stato archiviato per un oggetto chiave specificato affinché il tenant sia Attivo. Poiché può essere presente una sola chiave del tenant attiva in qualsiasi momento, la chiave del tenant attiva in precedenza viene impostata automaticamente su Archiviato.

I nuovi utenti di Azure Information Protection usano immediatamente la chiave del tenant identificata per proteggere il contenuto. Gli utenti esistenti del servizio passano gradualmente dalla chiave del tenant precedentemente attiva alla chiave del tenant appena attiva e questa transizione sfalsata può richiedere alcune settimane. È possibile forzare l'aggiornamento nei client inizializzando nuovamente l'ambiente utente (noto anche come bootstrap). I documenti e i file protetti con la chiave del tenant precedentemente attiva rimangono accessibili agli utenti autorizzati usando la chiave del tenant ora archiviata.

L'impostazione dello stato dell'oggetto chiave tenant su Attivo riassegna anche tutti i modelli di protezione con la chiave del tenant appena attiva. Poiché può essere un'operazione dispendiosa in termini di tempo, soprattutto se si dispone di molti modelli di protezione, non è consigliabile eseguire questa operazione di frequente.

Per eseguire questo cmdlet, è necessario specificare KeyIdentifier per l'oggetto chiave del tenant da impostare su Attivo. Per ottenere questo valore, usare il cmdlet Get-AipServiceKeys .

A meno che non ci si trovi al centro di una migrazione da AD RMS, non attivare una chiave RSA a 1024 bit, considerata un livello di protezione inadeguato. Microsoft non approva l'uso di lunghezze di chiave inferiori, ad esempio chiavi RSA a 1024 bit e l'uso associato di protocolli che offrono livelli di protezione inadeguati, ad esempio SHA-1. È consigliabile passare a una lunghezza di chiave superiore.

Per altre informazioni sulla chiave del tenant, vedere pianificazione e implementazione della chiave del tenant di Azure Information Protection.

Esempio

Esempio 1: Modificare lo stato di un oggetto chiave tenant in modo che sia attivo

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

Questo comando modifica lo stato di un oggetto chiave tenant da archiviato a Attivo. Il parametro KeyIdentifier identifica l'oggetto chiave del tenant da modificare ed è possibile trovare questo valore eseguendo Get-AipServiceKeys. L'oggetto chiave del tenant con stato precedentemente impostato su Active viene impostato automaticamente su Archived.

Poiché il comando specifica il parametro Force, il comando non richiede la conferma.

Esempio 2: Aggiornare SLC per riflettere il nome descrittivo del tenant

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

Questo comando recupera il nome descrittivo del tenant corrente da Azure Active Directory e aggiorna il contratto SLC in modo che le chiavi utente riflettano lo stesso nome.

Parametri

-Active

-Confirm

-Force

-KeyIdentifier

-RefreshSlcName

-WhatIf

Collegamenti correlati

• Get-AipServiceKeys