Get-AipServiceTemplateProperty
Obtém as propriedades de um modelo de proteção para a Proteção de Informações do Azure.
Sintaxe
Get-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names]
[-Descriptions]
[-RightsDefinitions]
[-ContentExpirationOption]
[-ContentExpirationDate]
[-ContentValidityDuration]
[-LicenseValidityDuration]
[-ReadOnly]
[-Status]
[-ScopedIdentities]
[-EnableInLegacyApps]
[<CommonParameters>] Description
O cmdlet Get-AipServiceTemplateProperty obtém propriedades especificadas de um modelo de proteção para a Proteção de Informações do Azure, usando o parâmetro TemplateId.
Informações de configuração semelhantes também podem ser exibidas no portal do Azure, mas esse cmdlet também inclui o GUID do modelo.
Você pode consultar propriedades de um modelo padrão ou um modelo personalizado. Para obter mais informações sobre modelos personalizados, incluindo como configurá-los no portal do Azure, consulte Configurando e gerenciando modelos para o Azure Information Protection.
Usando o cliente de rotulagem unificada da Proteção de Informações do Azure?
O cliente de etiquetagem unificada da Proteção de Informações do Azure usa modelos de proteção indiretamente. Se você tiver o cliente de rotulagem unificado, recomendamos que use cmdlets baseados em rótulo em vez de modificar seus modelos de proteção diretamente.
Para obter mais informações, consulte Criar e publicar rótulos de confidencialidade na documentação do Microsoft 365.
Exemplos
Exemplo 1: Obter a descrição e os direitos de uso de um modelo
PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitionsEste comando obtém a descrição e os direitos de uso para todos os usuários ou grupos configurados para o modelo de proteção especificado.
Exemplo 2: Para todos os modelos, obtenha o nome, os direitos de uso, se é um modelo padrão e se foi publicado ou arquivado
PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}O primeiro comando obtém todos os IDs de modelo e os armazena em uma variável. O segundo comando, em seguida, usa essa variável para obter o nome do modelo, os direitos de uso, se ele é somente leitura (True para um modelo padrão, False para um modelo personalizado) e o status (Published ou Archived) para cada modelo.
Parâmetros
-ContentExpirationDate
Lista a data em que o conteúdo protegido com o modelo expira.
Use esse parâmetro somente se ContentExpirationOption estiver definido como OnDate.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ContentExpirationOption
Obtém a definição de configuração de expiração de conteúdo para conteúdo protegido com o modelo.
Um dos seguintes valores é retornado:
Nunca. Indica que o conteúdo está disponível indefinidamente.
OnDate. Indica que o conteúdo expira em uma determinada data fixa.
AfterDays. Indica que o conteúdo está disponível pelo número de dias indicado após a sua proteção.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ContentValidityDuration
Lista o número de dias a partir do dia da proteção após o qual o conteúdo protegido com o modelo expira.
Use esse parâmetro somente se ContentExpirationOption estiver definido como AfterDays.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Descriptions
Lista as descrições do modelo em todas as localidades.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-EnableInLegacyApps
Indica o comportamento de um modelo departamental em aplicativos que não oferecem suporte a modelos departamentais (consulte o parâmetro ScopedIdentities).
Se definido como True e o modelo for um modelo departamental, todos os usuários que tentarem proteger o conteúdo de um aplicativo que não ofereça suporte a modelos departamentais verão o modelo e, portanto, poderão selecioná-lo, independentemente de os usuários serem membros do escopo de destino do modelo ou não.
Se definido como False, nenhum usuário verá e, portanto, não poderá selecionar o modelo em aplicativos que não oferecem suporte a modelos departamentais, mesmo que os usuários sejam membros do escopo de destino do modelo.
Essa configuração não tem efeito em modelos que não são modelos departamentais e também não tem efeito em aplicativos que suportam nativamente modelos departamentais.
Esse parâmetro é funcionalmente o equivalente à caixa de seleção Mostrar este modelo a todos os usuários quando os aplicativos não oferecem suporte à identidade do usuário quando você configura de compatibilidade de aplicativos no portal clássico do Azure (agora desativado). Não há nenhuma configuração equivalente no portal do Azure.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-LicenseValidityDuration
Lista o número de dias em que o conteúdo fica acessível offline após a aquisição de uma licença para consumi-lo.
-1 indica acesso ilimitado.
0 indica que deve ser obtida uma licença para cada utilização e que o conteúdo só está disponível online.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Names
Lista os nomes do modelo em todas as localidades.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ReadOnly
Indica se o modelo é um modelo padrão (True) e, portanto, não pode ser editado ou excluído, ou um modelo personalizado (False) e, portanto, pode ser editado ou excluído por um administrador.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RightsDefinitions
Lista os direitos concedidos a usuários ou grupos para o conteúdo protegido com o modelo.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ScopedIdentities
Lista os usuários por endereço de e-mail (conta ou grupo) que podem ver e, portanto, selecionar modelos departamentais de aplicativos.
Para que os usuários especificados vejam os modelos, o aplicativo deve oferecer suporte a modelos departamentais ou o parâmetro
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Status
O status do modelo:
- Os modelos de arquivados estão disponíveis para consumir conteúdo protegido anteriormente, mas não são exibidos para os usuários.
- Os modelos de publicados estão disponíveis para os usuários protegerem o conteúdo.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TemplateId
Especifica o GUID de um modelo de proteção.
Você pode usar o cmdlet Get-AipServiceTemplate para obter a ID do modelo de todos os modelos.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |