New-AIPCustomPermissions

Referência

Módulo:: AzureInformationProtection

Relevante para: Somente cliente de rotulagem unificada da AIP

Cria uma política de proteção ad hoc para permissões personalizadas.

Syntax

New-AIPCustomPermissions
   -Users <String[]>
   -Permissions <Permissions>
   [-ExpirationDate <DateTime>]
   [<CommonParameters>]

Description

O cmdlet New-AIPCustomPermissions cria um objeto de política de proteção ad hoc para permissões personalizadas que você armazena como uma variável e, em seguida, usa para proteger um arquivo ou arquivos ao executar o cmdlet de rotulagem, Set-AIPFileLabel.

Se o rótulo aplicado for configurado para configurações de proteção, as permissões personalizadas da política de proteção ad hoc substituirão as configurações de proteção do rótulo.

Exemplos

Exemplo 1 – Criar um objeto de política de proteção ad hoc para um único usuário

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

Esse comando cria um objeto de política de proteção ad hoc que concede ao usuário1contoso.com direitos de uso das permissões do Revisor e armazena essa política em uma variável nomeada permissões. Essa política de proteção ad hoc pode ser usada para aplicar proteção a um arquivo ou arquivos.

Não há nenhuma saída exibida para este comando.

Exemplo 2 – Criar um objeto de política de proteção ad hoc para vários usuários e que tenha uma data de validade

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)

Esse comando cria um objeto de política de proteção ad hoc que concede aos usuários de diferentes organizações direitos de uso das permissões do Revisor e também aplica uma data de validade. O objeto de política de proteção ad hoc é armazenado em uma variável nomeada permissões, que podem ser usadas para aplicar essa proteção a um arquivo ou arquivos.

Não há nenhuma saída exibida para este comando.

Parâmetros

-ExpirationDate

Especifica uma data de validade para a política de proteção ad hoc.

Após essa data de expiração, os usuários especificados não poderão mais acessar o arquivo ou os arquivos. No entanto, o proprietário e um superusuário sempre podem acessar o arquivo, mesmo após o período de expiração ser atingido.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Permissions

Especifica um nível de permissões que agrupa os direitos de uso que normalmente são usados juntos. Use esse parâmetro e o parâmetro Usuários para conceder direitos de uso aos usuários especificados.

Para ver quais direitos de uso individuais estão incluídos em cada um dos níveis de permissões, consulte Direitos incluídos nos níveis de permissão.

Type:	Permissions
Accepted values:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Users

Especifica os usuários que terão direitos para usar o arquivo ou os arquivos. Use esse parâmetro e o parâmetro Permissão para conceder direitos a usuários ou grupos especificados.

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None

Saídas

System.Object

Set-AIPFileLabel