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..
Utilize o cmdlet Get-Label para ver etiquetas de confidencialidade na 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
Nota: se a sua organização tiver mais etiquetas de confidencialidade han 1000, as definições de tempo limite definidas para a sessão do Powershell podem causar problemas de desempenho. Utilize o parâmetro SkipValidations para obter etiquetas de forma mais eficiente.
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 devolve uma lista de resumo de todas as etiquetas de confidencialidade na organização.
Exemplo 2
Get-Label -Identity "Engineering Group" | Format-List
Este exemplo devolve informações detalhadas para a etiqueta de confidencialidade denominada Grupo de Engenharia.
Parâmetros
-Identity
Aplicável: Conformidade do & de Segurança
O parâmetro Identidade especifica a etiqueta de confidencialidade que pretende ver. É possível usar qualquer valor que identifique o rótulo com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas 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: Conformidade do & de Segurança
O parâmetro IncludeDetailedLabelActions especifica se pretende expandir as ações de etiqueta em propriedades para uma 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: Conformidade do & de Segurança
{{ Fill 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: Conformidade do & de Segurança
O comutador SkipValidations especifica se pretende ignorar a obtenção de propriedades de encriptação configuradas em etiquetas de confidencialidade. Não é preciso especificar um valor com essa opção.
As organizações com mais de 1000 etiquetas podem utilizar este swtich para reduzir o tempo necessário para obter as etiquetas, o que ajuda a evitar problemas de tempo limite com Get-Label cmdlet.
Nota: a utilização deste comutador não ignora as validações quando obtém etiquetas. Apenas ignora a obtenção de propriedades do modelo de encriptação se estiverem configuradas para uma etiqueta. Pode obter essas propriedades individualmente com o parâmetro Identidade no comando Get-Label.
Este comutador não afeta a aplicação ou distribuição de etiquetas. A limitação só existe ao obter etiquetas 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: Conformidade do & de Segurança
{{ Fill 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.