Get-AipServiceTemplateProperty
Obtém as propriedades de um modelo de proteção para 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 as propriedades especificadas de um modelo de proteção para 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 Configurar e gerenciar modelos para o Azure Proteção de Informações.
Usando o cliente de rotulagem unificada Proteção de Informações do Azure?
O cliente de rotulagem unificada Proteção de Informações do Azure usa modelos de proteção indiretamente. Se você tiver o cliente de rotulagem unificada, recomendamos que você 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 -RightsDefinitionsEsse 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 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 todas as IDs de modelo e as armazena em uma variável. Em seguida, o segundo comando usa essa variável para obter o nome do modelo, os direitos de uso, seja somente leitura (True para um modelo padrão, False para um modelo personalizado) e o status (Publicado ou Arquivado) 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ContentExpirationOption
Obtém a configuração de configuração de expiração de conteúdo para conteúdo protegido com o modelo.
Um dos seguintes valores é retornado:
Never. Indica que o conteúdo está disponível indefinidamente.
OnDate. Indica que o conteúdo expira em uma determinada data.
AfterDays. Indica que o conteúdo está disponível pelo número de dias indicado após ser protegido.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ContentValidityDuration
Lista o número de dias 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Descriptions
Lista as descrições do modelo em todas as localidades.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableInLegacyApps
Indica o comportamento de um modelo departamental em aplicativos que não dão 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 dá 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 dão suporte a modelos departamentais, mesmo que os usuários sejam membros do escopo de destino do modelo.
Essa configuração não tem nenhum efeito nos modelos que não são modelos departamentais e também não tem efeito em aplicativos que oferecem suporte a modelos departamentais.
Esse parâmetro é funcionalmente o equivalente a Mostrar esse modelo a todos os usuários quando os aplicativos não dão suporte à caixa de seleção de identidade do usuário quando você configura a COMPATIBILIDADE DO APLICATIVO no portal clássico do Azure (agora desativado). Não há nenhuma configuração equivalente no portal do Azure.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LicenseValidityDuration
Lista o número de dias em que o conteúdo é acessível offline depois que uma licença para consumi-lo é adquirida.
-1 indica acesso ilimitado.
0 indica que uma licença deve ser obtida para cada uso e que o conteúdo só está disponível online.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Names
Lista os nomes do modelo em todas as localidades.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RightsDefinitions
Lista os direitos concedidos aos usuários ou grupos para o conteúdo protegido com o modelo.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ScopedIdentities
Lista os usuários pelo endereço de email (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 dar suporte a modelos departamentais ou o parâmetro EnableInLegacyApps deve ser definido como True.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Status
O status do modelo:
- Modelos arquivados estão disponíveis para consumir conteúdo protegido anteriormente, mas não são exibidos aos usuários.
-Os modelos publicados estão disponíveis para os usuários protegerem o conteúdo.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-TemplateId
Especifica o GUID de um modelo de proteção.
Você pode usar o cmdlet Get-AipServiceTemplate para obter a ID de modelo de todos os modelos.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |