Set-AipServiceTemplateProperty
Atualiza uma propriedade ou propriedades de um modelo de proteção para a Proteção de Informações do Azure.
Sintaxe
Set-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names <Hashtable>]
[-Descriptions <Hashtable>]
[-RightsDefinitions <System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]>]
[-ContentExpirationOption <ContentExpirationType>]
[-ContentExpirationDate <DateTime>]
[-ContentValidityDuration <Int32>]
[-LicenseValidityDuration <Int32>]
[-Status <TemplateStatus>]
[-ScopedIdentities <System.Collections.Generic.List`1[System.String]>]
[-EnableInLegacyApps <Boolean>]
[<CommonParameters>] Description
O cmdlet Set-AipServiceTemplateProperty atualiza uma propriedade ou propriedades de um modelo de proteção para a Proteção de Informações do Azure. Você pode atualizar a maioria dessas propriedades no portal do Azure.
Quando você usa esse cmdlet, o modelo é identificado por seu GUID, que deve se referir a um modelo de proteção existente. Não é possível usar esse cmdlet para atualizar os modelos padrão.
Você pode usar o cmdlet Get-AipServiceTemplate para obter a ID do modelo.
Importante
Quando você atualiza as propriedades de um modelo de proteção, as configurações existentes para essas propriedades serão substituídas (não complementadas) sem aviso, portanto, certifique-se de especificar todas as configurações necessárias para as propriedades que você está atualizando.
Como prática recomendada, faça backup do modelo existente antes de executar esse cmdlet, usando o cmdlet
Para obter mais informações sobre modelos de proteção, 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: Atualizar o status de um modelo
PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6428 -Status PublishedEste comando define um status de modelo como Publicado.
Exemplo 2: Especificar usuários e direitos para um modelo de proteção
PS C:\> $r1 = New-AipServiceRightsDefinition -EmailAddress marketing@contoso.com -Rights "VIEW","EXPORT"
PS C:\> $r2 = New-AipServiceRightsDefinition -EmailAddress engineering@contoso.com -Rights "VIEW"
PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6522 -RightsDefinitions ($r1, $r2)Este exemplo atualiza o modelo de proteção existente Novo Lançamento - Conteúdo Confidencial para novos usuários e direitos. Enquanto o modelo existente concedia direitos de visualização e exportação ao departamento de marketing (o que não deve ser alterado), o departamento de engenharia agora também deve ter direitos de visualização.
Como a especificação do parâmetro RightsDefinitions substitui as configurações existentes, o primeiro objeto de definição de direitos mantém as configurações existentes para marketing e outro objeto de definição de direitos cria os novos direitos do departamento de engenharia.
Exemplo 3: Adicionar novos usuários e direitos a um modelo de proteção
PS C:\> $templateid = "7b1db17a-cb1a-41cf-bad7-b452f9d384c1"
PS C:\> [array]$r = New-AipServiceRightsDefinition -EmailAddress pattiful@contoso.com -Rights "DOCEDIT", "EXTRACT"
PS C:\> $r += New-AipServiceRightsDefinition -EmailAddress evannar@vanarsdelltd.com -Rights "VIEW"
PS C:\> $CurrentRightsDefinitions = [array]((get-AipServiceTemplate -TemplateId $templateid).RightsDefinitions)
PS C:\> $ResultingRightsDefinitions = $CurrentRightsDefinitions + $r
PS C:\> Set-AipServiceTemplateProperty -TemplateId $templateid -RightsDefinition $ResultingRightsDefinitionsEsse conjunto de comandos adiciona dois novos usuários e seus direitos diferentes a um modelo existente, sem substituir os usuários existentes e os direitos já definidos no modelo.
Os novos usuários e seus direitos são pattiful.contoso.com (um usuário dentro da organização) que recebe DOCEDIT e EXTRACT direitos; e evannar@vanarsdelltd.com (um usuário de outra organização) a quem são concedidos direitos de VIEW. Esses usuários e seus direitos são adicionados a objetos de definição de direitos usando uma matriz, que é então adicionada às definições de direitos existentes para o modelo.
Parâmetros
-ContentExpirationDate
Especifica a data em que o conteúdo protegido com o modelo expira.
Use esse parâmetro somente se ContentExpirationOption estiver definido como OnDate.
| Tipo: | DateTime |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ContentExpirationOption
Especifica o tipo de expiração de conteúdo para conteúdo protegido com o modelo.
Os valores aceitáveis para este parâmetro são:
- 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 estará disponível pelo número de dias indicado após a sua proteção.
| Tipo: | ContentExpirationType |
| Valores aceites: | Never, OnDate, AfterDays |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ContentValidityDuration
Especifica o número de dias a partir do primeiro dia de proteção após o qual o conteúdo protegido com o modelo expira.
Use esse parâmetro somente se o parâmetro ContentExpirationOption estiver definido como AfterDays.
| Tipo: | Int32 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Descriptions
Especifica uma lista de descrições para o modelo.
Crie nomes e descrições para várias IDs de localidade usando a sintaxe de tabela de hash no Windows PowerShell. Deve haver pelo menos um par nome/descrição. Os IDs de localidade para nomes e descrições devem corresponder uns aos outros.
$descriptions = @{}
$descriptions[1033] = "Este conteúdo é confidencial e não deve ser partilhado externamente"
$descriptions[1034] = "Este conteúdo é confidencial e não debe ser compartido fuera de la organizacion"
| Tipo: | Hashtable |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-EnableInLegacyApps
Determina o comportamento de um modelo departamental em aplicativos cliente que não oferecem suporte a modelos departamentais. Para esse cenário, decida se todos os usuários podem ver modelos departamentais na lista de modelos disponíveis ou se nenhum usuário pode ver modelos departamentais na lista.
Os modelos departamentais podem ser criados usando o parâmetro
Se definido como True e o modelo for um modelo departamental, todos os usuários verão o modelo e, portanto, poderão selecioná-lo, independentemente de serem membros do escopo do modelo ou não.
Se definido como Falso, nenhum usuário vê e, portanto, não pode selecionar o modelo, 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 cliente que suportam nativamente modelos departamentais. Essa configuração também não tem efeito para o Outlook na Web que usa o Exchange Online em vez do Exchange local e, para esse cenário, os modelos departamentais nunca são exibidos aos usuários.
Observe que essa configuração não afeta se um usuário pode acessar o conteúdo protegido por um modelo departamental; isso afeta apenas a capacidade de um usuário ver e, portanto, selecionar o modelo em si.
Se tiver aplicações que não suportam modelos departamentais por predefinição, pode utilizar um de script de transferência de modelo RMS personalizado ou outras ferramentas para implementar estes modelos na pasta de cliente RMS local. Em seguida, esses aplicativos exibirão corretamente os modelos departamentais.
A partir de um computador cliente que tenha baixado todos os modelos, você pode copiar e colar os arquivos de modelo em outros computadores.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-LicenseValidityDuration
Especifica o período de validade das licenças de uso para conteúdo protegido com este modelo. O valor é especificado como o número de dias que o conteúdo fica disponível offline após a aquisição de uma licença de uso (0-9999). Durante este período, os utilizadores podem reabrir conteúdos a que acederam anteriormente sem necessitarem de uma ligação à Internet.
A redução desse valor dá mais controle aos proprietários de documentos, ajudando a garantir que o conteúdo que foi revogado ou cuja política foi alterada não possa ser acessado por muito tempo após essas alterações.
Aumentar esse valor dá mais liberdade aos usuários para acessar o conteúdo sem a necessidade de uma conexão de rede com a Internet.
Para especificar o acesso ilimitado, use -1.
Para especificar que uma licença de uso deve ser obtida cada vez que o conteúdo protegido é acessado e que o conteúdo está disponível apenas com uma conexão com a Internet, especifique 0.
Cada organização tem um tempo máximo de validade da licença de uso, que é 30 dias por padrão e pode ser configurado usando o Set-AipServiceMaxUseLicenseValidityTime. O valor especificado para o parâmetro LicenseValidityDuration deve ser menor que esse valor.
Quando há valores diferentes para o tempo de validade da licença de uso, por exemplo, um valor para o locatário e outro para o modelo, a Proteção de Informações do Azure usa o valor mais restritivo.
| Tipo: | Int32 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Names
Especifica uma lista de nomes para o modelo.
Não inclua nenhum dos seguintes caracteres no nome porque nem todos os serviços e aplicativos que usam a Proteção de Informações do Azure podem dar suporte a esses caracteres: < > % & / ? ; + \ : #
Crie nomes e descrições para várias IDs de localidade usando a sintaxe de tabela de hash no Windows PowerShell. Deve haver pelo menos um par nome/descrição. Os IDs de localidade para nomes e descrições devem corresponder uns aos outros.
$names = @{}
$names[1033] = "Conteúdo confidencial"
$names[1034] = "Contenido confidencial"
| Tipo: | Hashtable |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RightsDefinitions
Especifica uma lista de objetos de definição de direitos especificados usando o cmdlet
Esses objetos de definição de direitos expressam os direitos de conceder usuários individuais ou grupos ao conteúdo protegido pela aplicação do modelo.
| Tipo: | System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition] |
| 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: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Status
Especifica o status do modelo. Os valores válidos são: Publicado ou Arquivado.
- Os modelos arquivados estão disponíveis para consumir conteúdo protegido anteriormente, mas não são visíveis para os usuários.
- Os modelos publicados são distribuídos aos utilizadores e disponibilizados para proteger o conteúdo.
| Tipo: | TemplateStatus |
| Valores aceites: | Archived, Published |
| 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.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |