Get-AipServiceTemplateProperty
Obtém as propriedades de um modelo de proteção para a Azure Information Protection.
Syntax
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 Azure Information Protection, utilizando o parâmetro TemplateId.
Informações de configuração semelhantes também podem ser vistas no portal do Azure, mas este cmdlet também inclui o modelo GUID.
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 gerir modelos para a Azure Information Protection.
Utilizar o Azure Information Protection cliente de rotulagem unificado?
O Azure Information Protection cliente de rotulagem unificada usa modelos de proteção indiretamente. Se tiver o cliente de rotulagem unificado, recomendamos que utilize cmdlets baseados em etiquetas em vez de modificar diretamente os seus modelos de proteção.
Para obter mais informações, consulte Criar e publicar etiquetas de sensibilidade na documentação da Microsoft 365.
Exemplos
Exemplo 1: Obtenha a descrição e os direitos de utilização de um modelo
PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitions
Este comando obtém a descrição e os direitos de utilização de todos os utilizadores ou grupos configurados para o modelo de proteção especificado.
Exemplo 2: Para todos os modelos, obtenha o nome, os direitos de utilização, seja um modelo padrão, e seja 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 do modelo e armazena-os numa variável. O segundo comando usa então esta variável para obter o nome do modelo, os direitos de utilização, se é apenas leitura (Verdadeiro para um modelo padrão, Falso para um modelo personalizado), e o estado (Publicado ou Arquivado) para cada modelo.
Parâmetros
-ContentExpirationDate
Lista a data em que o conteúdo protegido com o modelo expira.
Utilize este parâmetro apenas se a ContentExpirationOption estiver definida para o OnDate.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 é devolvido:
Nunca, nunca. Indica que o conteúdo está disponível indefinidamente.
No Dia do 10. Indica que o conteúdo expira numa determinada data fixa.
Depois dos Dias. Indica que o conteúdo está disponível para o número indicado de dias após a sua proteção.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Utilize este parâmetro apenas se a ContentExpirationOptionoption estiver definida para AfterDays.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Descriptions
Lista as descrições do modelo em todos os locais.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableInLegacyApps
Indica o comportamento de um modelo departacional em aplicações que não suportam modelos departameiros (ver o parâmetro ScopedIdentities ).
Se definido para True e o modelo é um modelo departacional, todos os utilizadores que tentem proteger o conteúdo de uma aplicação que não suporta modelos departamâneos verão o modelo e, portanto, poderão selecioná-lo, independentemente de os utilizadores serem ou não membros do âmbito alvo do modelo.
Se definido para Falso, nenhum utilizadores vê e, portanto, não pode selecionar o modelo em aplicações que não suportam modelos departameiros, mesmo que os utilizadores sejam membros do âmbito alvo do modelo.
Esta definição não tem qualquer efeito em modelos que não são modelos departameiros e também não tem nenhum efeito em aplicações que suportam modelos departameiros nativos.
Este parâmetro é funcionalmente o equivalente ao 'Mostrar' a todos os utilizadores quando as aplicações não suportam a caixa de verificação de identidade do utilizador quando configurar a COMPATIBILIDADE DA APLICAÇÃO no portal clássico Azure (agora reformado). Não há uma definição equivalente no portal do Azure.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseValidityDuration
Lista o número de dias de conteúdo é acessível offline após a aquisição de uma licença para consumi-lo.
-1 indica acesso ilimitado.
0 indica que uma licença deve ser obtida para cada utilização e que o conteúdo só está disponível online.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Names
Lista os nomes do modelo em todos os locais.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReadOnly
Indica se o modelo é um modelo padrão (Verdadeiro) e, portanto, não pode ser editado ou eliminado, ou um modelo personalizado (Falso) e, portanto, pode ser editado ou eliminado por um administrador.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RightsDefinitions
Lista os direitos concedidos aos utilizadores ou grupos para o conteúdo protegido com o modelo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScopedIdentities
Lista os utilizadores por endereço de e-mail (conta ou grupo) que podem ver e, portanto, selecionar modelos departameiros a partir de aplicações.
Para que os utilizadores especificados vejam os modelos, a aplicação deve suportar modelos departameiros ou o parâmetro EnableInLegacyApps deve ser definido como True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Status
O estado do modelo:
-Os modelos arquivados estão disponíveis para consumir conteúdo previamente protegido, mas não são apresentados aos utilizadores.
-Os modelos publicados estão disponíveis para os utilizadores para proteger o conteúdo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateId
Especifica o GUID de um modelo de proteção.
Pode utilizar o cmdlet Get-AipServiceTemplate para obter o ID do modelo de todos os modelos.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |