New-AIPCustomPermissions

Referência

Módulo:: AzureInformationProtection

Relevante para: Cliente de rotulagem unificada da AIP apenas

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 armazena como variável e depois utiliza para proteger um ficheiro ou ficheiros quando executar o cmdlet de rotulagem, Set-AIPFileLabel.

Se a etiqueta que é aplicada estiver configurada para definições de proteção, as permissões personalizadas da política de proteção ad-hoc substituem as definições de proteção do rótulo.

Exemplos

Exemplo 1 - Criar um objeto de política de proteção ad-hoc para um único utilizador

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

Este comando cria um objeto de política de proteção ad-hoc que concede ao utilizador1contoso.com direitos de utilização das permissões do Revisor e armazena esta política numa variável nomeada permissões. Esta política de proteção ad-hoc pode então ser utilizada para aplicar proteção a um ficheiro ou ficheiros.

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

Exemplo 2 - Criar um objeto de política de proteção ad-hoc para vários utilizadores 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)

Este comando cria um objeto de política de proteção ad-hoc que concede aos utilizadores de diferentes organizações direitos de utilização a partir das permissões do Revisor, e também aplica uma data de validade. O objeto de política de proteção ad-hoc é armazenado numa variável com o nome de permissões, que podem ser usadas para aplicar esta proteção a um ficheiro ou ficheiros.

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

Parâmetros

-ExpirationDate

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

Após esta data de validade, os utilizadores especificados deixarão de poder aceder ao ficheiro ou ficheiros. No entanto, o proprietário e um super utilizador podem sempre aceder ao ficheiro, mesmo depois de atingido o período de validade.

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 agru como grupos direitos de utilização que são normalmente usados em conjunto. Utilize este parâmetro e o parâmetro Utilizadores para conceder direitos de utilização aos utilizadores especificados.

Para ver quais direitos de utilização individuais estão incluídos em cada um dos níveis de permissões, consulte os 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 utilizadores que terão o direito de utilizar o ficheiro ou ficheiros. Utilize este parâmetro e o parâmetro De permissão para conceder direitos a utilizadores 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