Compartilhar via


New-CustomPermissions

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 você armazena como uma variável e, em seguida, usa para proteger um arquivo ou arquivos ao executar o cmdlet de rotulagem, Set-FileLabel.

Se o rótulo aplicado estiver 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-CustomPermissions -Users user1@contoso.com -Permissions Viewer

Esse comando cria um objeto de política de proteção ad hoc que concede ao usuário1 direitos de uso de contoso.com das permissões do Revisor e armazena essa política em uma variável chamada 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-CustomPermissions -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 chamada permissões, que pode ser usada 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.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 Users 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.

Tipo:Permissions
Valores aceitos:Viewer, Reviewer, CoAuthor, CoOwner
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Users

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object