Add-AipServiceTemplate

Sintaxe

Default (Default)

Add-AipServiceTemplate
    -Descriptions <Hashtable>
    -Names <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

Exemplos

Exemplo 1: criar um modelo departamental para conteúdo confidencial

PS C:\> $names = @{}
PS C:\> $names[1033] = "New Launch - Confidential content"
PS C:\> $names[1034] = " Nuevo Lanzamiento - Contenido confidencial"
PS C:\> $descriptions = @{}
PS C:\> $descriptions[1033] = "This content is confidential for people working on the New Launch project and should not be shared externally"
PS C:\> $descriptions[1034] = "Este contenido es confidencial para empleados trabajando en el proyecto Nuevo Lanzamiento y no debe ser compartido fuera de la organización"
PS C:\> $r1 = New-AipServiceRightsDefinition -EmailAddress marketing@contoso.com -Rights "VIEW","EXPORT"
PS C:\> $r2 = New-AipServiceRightsDefinition -EmailAddress engineering@contoso.com -Rights "VIEW","DOCEDIT"
PS C:\> Add-AipServiceTemplate -Names $names -Descriptions $Descriptions -LicenseValidityDuration 5 -RightsDefinitions $r1, $r2 -ScopedIdentities engineering@contoso.com -Status Published

Parâmetros

-ContentExpirationDate

Especifica a data em que o conteúdo protegido com o modelo expira.

Use esse parâmetro somente se o parâmetro ContentExpirationOption estiver definido como OnDate.

Propriedades do parâmetro

Conjuntos de parâmetros

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

• 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

Conjuntos de parâmetros

-ContentValidityDuration

Especifica o número de dias 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-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. As IDs de localidade para nomes e descrições devem corresponder umas às outras. Se uma ID de localidade for especificada, seu valor deverá conter uma cadeia de caracteres não vazia.

$descriptions = @{}

$descriptions[1033] = "Esse conteúdo é confidencial e não deve ser compartilhado externamente"

$descriptions[1034] = "Este contenido es confidencial y no debe ser compartido fuera de la organización"

Propriedades do parâmetro

Conjuntos de parâmetros

-EnableInLegacyApps

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

Observação: esse parâmetro é funcionalmente o 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 se você configurou de COMPATIBILIDADE DE APLICATIVO no portal clássico do Azure. O portal clássico agora está desativado e não há nenhuma configuração equivalente no portal do Azure.

O cliente da Proteção de Informações do Azure dá suporte a modelos departamentais, enquanto o Outlook na Web e o Exchange ActiveSync são exemplos de aplicativos que atualmente não dão suporte a modelos departamentais. Para esses aplicativos do Exchange (e todos os outros aplicativos que não podem dar suporte a modelos departamentais), você deve decidir se todos os usuários podem selecionar um modelo departamental na lista de modelos disponíveis ou se nenhum usuário pode selecionar um modelo departamental na lista.

Essa configuração não afeta se um usuário pode acessar o conteúdo protegido por um modelo departamental; afeta apenas a capacidade de um usuário selecionar o próprio modelo.

Se você tiver aplicativos que não dão suporte a modelos departamentais por padrão, poderá usar uma script de download de modelo RMS personalizado ou outras ferramentas para implantar esses modelos na pasta de cliente RMS local. Em seguida, esses aplicativos exibirão corretamente os modelos departamentais.

Em um computador cliente que baixou todos os modelos, você pode copiar e colar os arquivos de modelo em outros computadores.

Propriedades do parâmetro

Conjuntos de parâmetros

-LicenseValidityDuration

Especifica o período de validade das licenças de uso para conteúdo protegido com esse modelo.

O valor é especificado como o número de dias em que o conteúdo está disponível offline depois que uma licença de uso é adquirida (0-9999). Durante esse período, os usuários podem reabrir o conteúdo que acessaram anteriormente sem a necessidade de uma conexão de rede da 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 para o qual a 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 exigir uma conexão de rede da Internet.

Para especificar o acesso ilimitado, use -1. Para especificar que uma licença de uso deve ser obtida sempre que o conteúdo protegido for acessado e que o conteúdo esteja disponível apenas com uma conexão com a Internet, especifique 0.

Cada organização tem um tempo máximo de validade de licença de uso, que é 30 dias por padrão e pode ser configurado usando oSet-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 um para o modelo, a Proteção de Informações do Azure usa o valor mais restritivo.

Propriedades do parâmetro

Conjuntos de parâmetros

-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. As IDs de localidade para nomes e descrições devem corresponder umas às outras. Se uma ID de localidade for especificada, seu valor deverá conter uma cadeia de caracteres não vazia.

$names = @{}

$names[1033] = "Conteúdo confidencial"

$names[1034] = "Contenido confidencial"

Propriedades do parâmetro

Conjuntos de parâmetros

-RightsDefinitions

Especifica uma lista de objetos de definição de direitos especificados usando o cmdlet New-AipServiceRightsDefinition.

Esses objetos de definição de direitos expressam os direitos de conceder usuários ou grupos individuais ao conteúdo protegido pela aplicação do modelo.

Os objetos de definição de direitos contêm o endereço de email da identidade e os direitos a serem atribuídos a ela.

Propriedades do parâmetro

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-Status

Especifica o status do modelo.

Os valores permitidos são arquivados e publicados.

• 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 usuários e disponibilizados para proteger o conteúdo.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

System.String

Links Relacionados

• Export-AipServiceTemplate
• Get-AipServiceTemplate
• Import-AipServiceTemplate
• New-AipServiceRightsDefinition
• Remove-AipServiceTemplate