Compartilhar via


Get-AipServiceTemplateProperty

Obtém as propriedades de um modelo de proteção para a Proteção de Informações do Azure.

Sintaxe

Default (Default)

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 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 Configurar e gerenciar modelos para a Proteção de Informações do Azure.

Usando o cliente de rotulagem unificada da Proteção de Informações do Azure?

O cliente de rotulagem 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 você use cmdlets baseados em rótulo em vez de modificar seus modelos de proteção diretamente.

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

Esse 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, 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 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 ele 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.

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

-ContentExpirationOption

Obtém a 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.

  • Em data. Indica que o conteúdo expira em uma determinada data fixa.

  • Dias posteriores. Indica que o conteúdo está disponível para o número indicado de dias após sua proteçã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

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

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

-Descriptions

Lista as descrições do modelo em todas as localidades.

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

-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 efeito sobre modelos que não são modelos departamentais e também não tem efeito sobre aplicativos que dão suporte nativo a modelos departamentais.

Esse parâmetro é funcionalmente equivalente ao Mostrar esse modelo a todos os usuários quando os aplicativos não dão suporte à identidade do usuário caixa de seleção quando você configura de COMPATIBILIDADE DE APLICATIVO no portal clássico do Azure (agora desativado). Não há nenhuma configuração equivalente no portal do Azure.

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

-LicenseValidityDuration

Lista o número de dias em que o conteúdo está 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.

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

-Names

Lista os nomes do modelo em todas as localidades.

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

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

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

-RightsDefinitions

Lista os direitos concedidos aos usuários ou grupos para o conteúdo protegido com o modelo.

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

-ScopedIdentities

Lista os usuários por 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.

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

-Status

O status do modelo:

- modelos de arquivados estão disponíveis para consumir conteúdo protegido anteriormente, mas não são exibidos aos usuários.

- Modelos de publicados estão disponíveis para os usuários protegerem o conteúdo.

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

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

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
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, consulte about_CommonParameters.