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 di PowerShell potrebbero causare problemi di prestazioni. Usare 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
In questo esempio viene restituito un elenco riepilogativo di tutte le etichette di riservatezza nell'organizzazione.
Esempio 2
Get-Label -Identity "Engineering Group" | Format-List
In questo esempio vengono restituite informazioni dettagliate per l'etichetta di riservatezza denominata Engineering Group.
Parametri
-Identity
Applicabile: Conformità & sicurezza
Il parametro Identity consente di specificare l'etichetta di riservatezza da 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 fosse stato eseguito il comando Get- senza il parametro Identity. Verificare che 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: Conformità & sicurezza
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: Conformità & sicurezza
{{ 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: Conformità & sicurezza
L'opzione SkipValidations specifica 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 questo swtich per ridurre il tempo necessario per recuperare le etichette, evitando problemi di timeout con Get-Label cmdlet.
Nota: l'uso di questa opzione non ignora le convalide quando si recuperano le etichette. Ignora il recupero delle proprietà del modello di crittografia solo se sono configurate per un'etichetta. È possibile ottenere tali proprietà singolarmente usando il parametro Identity nel comando Get-Label.
Questa opzione non influisce sull'applicazione di etichette o sulla distribuzione. La limitazione esiste solo quando si recuperano le etichette per le 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: Conformità & sicurezza
{{ 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.