Partilhar via

Get-AadrmTemplateProperty

  • Referência
Módulo:
AADRM

Obtém as propriedades de um modelo de Gestão de Direitos.

Sintaxe

Get-AadrmTemplateProperty
   -TemplateId <Guid>
   [-Names]
   [-Descriptions]
   [-RightsDefinitions]
   [-ContentExpirationOption]
   [-ContentExpirationDate]
   [-ContentValidityDuration]
   [-LicenseValidityDuration]
   [-ReadOnly]
   [-Status]
   [-ScopedIdentities]
   [-EnableInLegacyApps]
   [<CommonParameters>]

Description

Nota

Este cmdlet do módulo AADRM está agora depreciado. Depois de 15 de julho de 2020, este nome cmdlet será suportado apenas como um pseudónimo à sua substituição no módulo AIPService.

Para mais informações, consulte a página geral.

O cmdlet Get-AadrmTemplateProperty obtém propriedades especificadas de um modelo de Gestão de Direitos Azure, 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.

Exemplos

Exemplo 1: Obtenha a descrição e os direitos de utilização de um modelo

PS C:\>Get-AadrmTemplateProperty -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 especificado de Gestão de Direitos.

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-AadrmTemplate PS C:\>foreach ($template in $templates) {Get-AadrmTemplateProperty -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.

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 é 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.

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.

Utilize este parâmetro apenas se a ContentExpirationOptionoption estiver definida para 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 todos os locais.

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 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.

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 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.

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 todos os locais.

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 (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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RightsDefinitions

Lista os direitos concedidos aos utilizadores 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 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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

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 Gestão de Direitos.

Pode utilizar o cmdlet Get-AadrmTemplate para obter o 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