Get-Label
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Use o cmdlet Get-Label para exibir rótulos de confidencialidade em sua organização.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-Label
[[-Identity] <ComplianceRuleIdParameter>]
[-IncludeDetailedLabelActions]
[-SkipValidations]
[-ReturnModernLabelScheme]
[-ValidateContentTypeRemoval]
[<CommonParameters>]
Description
Observação: se sua organização tiver mais rótulos de confidencialidade han 1000, as configurações de tempo limite definidas para a sessão do Powershell poderão causar problemas de desempenho. Use o parâmetro SkipValidations para recuperar rótulos com mais eficiência.
Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
Get-Label
Este exemplo retorna uma lista resumida de todos os rótulos de confidencialidade da organização.
Exemplo 2
Get-Label -Identity "Engineering Group" | Format-List
Este exemplo retorna informações detalhadas para o rótulo de confidencialidade denominado Grupo de Engenharia.
Parâmetros
-Identity
Aplicável: Segurança & Conformidade
O parâmetro Identity especifica o rótulo de confidencialidade que você deseja exibir. É possível usar qualquer valor que identifique o rótulo com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | ComplianceRuleIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeDetailedLabelActions
Aplicável: Segurança & Conformidade
O parâmetro IncludeDetailedLabelActions especifica se as ações de rótulo devem ser expandidas em propriedades para melhor legibilidade. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ReturnModernLabelScheme
Aplicável: Segurança & Conformidade
{{ Preencher ReturnModernLabelScheme Description }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SkipValidations
Aplicável: Segurança & Conformidade
A opção SkipValidations especifica se a recuperação das propriedades de criptografia configuradas em rótulos de confidencialidade deve ser ignorada. Não é preciso especificar um valor com essa opção.
Organizações com mais de 1000 rótulos podem usar essa opção para reduzir o tempo necessário para buscar os rótulos, o que ajuda a evitar problemas de tempo limite com Get-Label cmdlet.
Observação: usar essa opção não ignora as validações quando você recupera rótulos. Ele só ignora a recuperação das propriedades do modelo de criptografia se elas estiverem configuradas para um rótulo. Você pode obter essas propriedades individualmente usando o parâmetro Identity no comando Get-Label.
Essa opção não afeta a aplicação ou distribuição do rótulo. A limitação existe apenas ao buscar rótulos para operações CRUD.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ValidateContentTypeRemoval
Aplicável: Segurança & Conformidade
{{ Preencher: ValidateContentTypeRemoval Description }}
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.