Get-AipServiceTemplateProperty
Ottiene le proprietà di un modello di protezione per Azure Information Protection.
Sintassi
Get-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names]
[-Descriptions]
[-RightsDefinitions]
[-ContentExpirationOption]
[-ContentExpirationDate]
[-ContentValidityDuration]
[-LicenseValidityDuration]
[-ReadOnly]
[-Status]
[-ScopedIdentities]
[-EnableInLegacyApps]
[<CommonParameters>] Descrizione
Il cmdlet Get-AipServiceTemplateProperty ottiene le proprietà specificate di un modello di protezione per Azure Information Protection usando il parametro TemplateId.
Le informazioni di configurazione simili possono essere visualizzate anche nel portale di Azure, ma questo cmdlet include anche il GUID del modello.
È possibile eseguire query su proprietà di un modello predefinito o di un modello personalizzato. Per altre informazioni sui modelli personalizzati, tra cui come configurarli nel portale di Azure, vedere Configurazione e gestione dei modelli per Azure Information Protection.
Uso del client di etichettatura unificata di Azure Information Protection?
Il client di etichettatura unificata di Azure Information Protection usa indirettamente i modelli di protezione. Se si dispone del client di etichettatura unificata, è consigliabile usare i cmdlet basati su etichette anziché modificare direttamente i modelli di protezione.
Per altre informazioni, vedere Creare e pubblicare etichette di riservatezza nella documentazione di Microsoft 365.
Esempio
Esempio 1: Ottenere la descrizione e i diritti di utilizzo per un modello
PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitionsQuesto comando ottiene la descrizione e i diritti di utilizzo per tutti gli utenti o i gruppi configurati per il modello di protezione specificato.
Esempio 2: per tutti i modelli, ottenere il nome, i diritti di utilizzo, se un modello predefinito e se sono stati pubblicati o archiviati
PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}Il primo comando ottiene tutti gli ID modello e li archivia in una variabile. Il secondo comando usa quindi questa variabile per ottenere il nome del modello, i diritti di utilizzo, se è di sola lettura (True per un modello predefinito, False per un modello personalizzato) e lo stato (Pubblicato o Archiviato) per ogni modello.
Parametri
-ContentExpirationDate
Elenca la data di scadenza del contenuto protetto con il modello.
Usare questo parametro solo se ContentExpirationOption è impostato su OnDate.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ContentExpirationOption
Ottiene l'impostazione di configurazione della scadenza del contenuto per il contenuto protetto con il modello.
Viene restituito uno dei valori seguenti:
Never. Indica che il contenuto è disponibile per un tempo illimitato.
OnDate. Indica che il contenuto scade alla data stabilita.
AfterDays. Indica che il contenuto è disponibile per il numero di giorni indicato dopo l'applicazione della protezione.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ContentValidityDuration
Elenca il numero di giorni dal giorno della protezione dopo il quale il contenuto protetto con il modello scade.
Utilizzare questo parametro solo se ContentExpirationOption è impostato su AfterDays.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Descriptions
Elenca le descrizioni per il modello in tutte le impostazioni locali.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-EnableInLegacyApps
Indica il comportamento di un modello di reparto nelle applicazioni che non supportano i modelli di reparto (vedere il parametro ScopedIdentities ).
Se è impostato su True e il modello è un modello di reparto, tutti gli utenti che tentano di proteggere il contenuto da un'applicazione che non supporta i modelli di reparto visualizzeranno il modello e potranno quindi selezionarlo, indipendentemente dal fatto che gli utenti siano membri dell'ambito di destinazione del modello.
Se è impostata su False, nessun utente visualizza e pertanto non può selezionare il modello nelle applicazioni che non supportano i modelli di reparto, anche se gli utenti sono membri dell'ambito di destinazione del modello.
Questa impostazione non ha alcun effetto sui modelli non di reparto e sulle applicazioni che supportano in modo nativo i modelli di reparto.
Questo parametro è funzionalmente l'equivalente della casella di controllo Mostra questo modello a tutti gli utenti quando le applicazioni non supportano l'identità utente quando si configura LA COMPATIBILITÀ DELLE APPLICAZIONI nel portale di Azure classico (ora ritirato). Non esiste alcuna impostazione equivalente nella portale di Azure.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-LicenseValidityDuration
Elenca il numero di giorni in cui il contenuto è accessibile offline dopo l'acquisizione di una licenza per utilizzarlo.
-1 indica l'accesso illimitato.
0 indica che è necessario ottenere una licenza per ogni utilizzo e che il contenuto è disponibile solo online.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Names
Elenca i nomi per il modello in tutte le impostazioni locali.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ReadOnly
Indica se il modello è un modello predefinito (True) e pertanto non può essere modificato o eliminato oppure un modello personalizzato (False) e pertanto può essere modificato o eliminato da un amministratore.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RightsDefinitions
Elenca i diritti concessi a utenti o gruppi per il contenuto protetto con il modello.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ScopedIdentities
Elenca gli utenti in base all'indirizzo e-mail (account o gruppo) in grado di visualizzare e pertanto selezionare modelli di reparto dalle applicazioni.
Affinché gli utenti specificati visualizzino i modelli, l'applicazione deve supportare i modelli di reparto o il parametro EnableInLegacyApps deve essere impostato su True.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Status
Stato del modello:
- I modelli archiviati sono disponibili per utilizzare contenuto protetto in precedenza, ma non vengono visualizzati agli utenti.
- I modelli pubblicati sono disponibili per gli utenti per proteggere il contenuto.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TemplateId
Specifica il GUID di un modello di protezione.
È possibile usare il cmdlet Get-AipServiceTemplate per ottenere l'ID modello di tutti i modelli.
| Tipo: | Guid |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |