Get-Label
Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.
Usare il cmdlet Get-Label per visualizzare le etichette di riservatezza nell'organizzazione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Get-Label
[[-Identity] <ComplianceRuleIdParameter>]
[-IncludeDetailedLabelActions]
[-SkipValidations]
[-ReturnModernLabelScheme]
[-ValidateContentTypeRemoval]
[<CommonParameters>]
Descrizione
Nota: se l'organizzazione ha più etichette di riservatezza han 1000, le impostazioni di timeout impostate per la sessione PowerShell potrebbero causare problemi di prestazioni. Utilizzare il parametro SkipValidations per recuperare le etichette in modo più efficiente.
Per usare questo cmdlet in PowerShell per sicurezza e conformità, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.
Esempio
Esempio 1
Get-Label
Questo esempio restituisce un elenco di riepilogo di tutte le etichette di riservatezza nell'organizzazione.
Esempio 2
Get-Label -Identity "Engineering Group" | Format-List
Questo esempio restituisce informazioni dettagliate per l'etichetta di riservatezza denominata Engineering Group.
Parametri
-Identity
Applicabile: Sicurezza & conformità
Il parametro Identity consente di specificare l'etichetta di riservatezza che si desidera visualizzare. È possibile usare qualsiasi valore che identifichi l'etichetta in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
Attenzione: il valore $null o un valore inesistente per il parametro Identity restituisce tutti gli oggetti come se si eseguisse il comando Get- senza il parametro Identity. Verificare che tutti gli elenchi di valori per il parametro Identity siano accurati e non contengano valori $null inesistenti.
Proprietà dei parametri
| Tipo: | ComplianceRuleIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-IncludeDetailedLabelActions
Applicabile: Sicurezza & conformità
Il parametro IncludeDetailedLabelActions consente di specificare se espandere le azioni delle etichette in proprietà per una migliore leggibilità. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ReturnModernLabelScheme
Applicabile: Sicurezza & conformità
{{ Fill ReturnModernLabelScheme Description }}
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SkipValidations
Applicabile: Sicurezza & conformità
L'opzione SkipValidations consente di specificare se ignorare il recupero delle proprietà di crittografia configurate nelle etichette di riservatezza. Con questa opzione non è necessario specificare alcun valore.
Le organizzazioni con più di 1000 etichette possono usare questa opzione per ridurre il tempo necessario per recuperare le etichette, in modo da evitare problemi di timeout con Get-Label cmdlet.
Nota: l'uso di questa opzione non salta le convalide quando recuperi le etichette. Salta solo il recupero delle proprietà del modello di crittografia se sono configurate per un'etichetta. È possibile ottenere queste proprietà singolarmente usando il parametro Identity nel comando Get-Label.
Questo interruttore non influisce sull'applicazione o la distribuzione delle etichette. La limitazione esiste solo quando si recuperano etichette per operazioni CRUD.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ValidateContentTypeRemoval
Applicabile: Sicurezza & conformità
{{ Fill ValidateContentTypeRemoval Description }}
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.