New-CustomPermissions

Referência

Módulo:: PurviewInformationProtection

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

Sintaxe

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

Description

O cmdlet New-CustomPermissions cria um objeto de política de proteção ad hoc para permissões personalizadas que armazena como uma variável e, em seguida, utiliza para proteger um ficheiro ou ficheiros quando executa o cmdlet de etiquetagem Set-FileLabel.

Se a etiqueta 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 da etiqueta.

Exemplos

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

PS C:\> $permissions = New-CustomPermissions -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 a partir das permissões do Revisor e armazena esta política numa variável denominada permissões. Esta política de proteção ad hoc pode ser utilizada para aplicar proteção a um ficheiro ou ficheiro.

Não é apresentada nenhuma 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 expiração

PS C:\> $permissions = New-CustomPermissions -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 expiração. O objeto de política de proteção ad hoc é armazenado numa variável com o nome permissões, que pode ser utilizada para aplicar esta proteção a um ficheiro ou ficheiros.

Não é apresentada nenhuma saída para este comando.

Parâmetros

-ExpirationDate

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

Após esta data de expiração, os utilizadores especificados deixarão de poder aceder ao ficheiro ou ficheiros. No entanto, o proprietário e um superutilizador podem sempre aceder ao ficheiro, mesmo após o período de expiração ser atingido.

Tipo:	DateTime
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Permissions

Especifica um nível de permissões que agrupa os direitos de utilização normalmente utilizados em conjunto. Utilize este parâmetro e o parâmetro Utilizadores para conceder direitos de utilização a utilizadores especificados.

Para ver que direitos de utilização individuais estão incluídos em cada um dos níveis de permissões, veja Direitos incluídos nos níveis de permissão.

Tipo:	Permissions
Valores aceites:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Users

Especifica os utilizadores que terão direitos para utilizar o ficheiro ou ficheiros. Utilize este parâmetro e o parâmetro Permissão para conceder direitos a utilizadores ou grupos especificados.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

System.Object

Partilhar via