New-CustomPermissions
Cria uma política de proteção ad hoc para permissões personalizadas.
Sintaxe
Default (Default)
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
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 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 de contoso.com direitos de uso 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á 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 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)
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 de Revisor e também aplica uma data de expiração. O objeto de política de proteção ad hoc é armazenado em uma variável chamada permissions, que pode ser usada para aplicar essa proteção a um arquivo ou arquivos.
Não há saída exibida para este comando.
Parâmetros
-ExpirationDate
Especifica uma data de expiração 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 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.
Propriedades do parâmetro
| Tipo: | DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 a usuários especificados.
Para ver quais direitos de uso individuais estão incluídos em cada um dos níveis de permissão, consulte Direitos incluídos nos níveis de permissão.
Propriedades do parâmetro
| Tipo: | Permissions |
| Valor padrão: | None |
| Valores aceitos: | Viewer, Reviewer, CoAuthor, CoOwner |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Users
Especifica os usuários que terão direitos para usar o arquivo ou arquivos. Use esse parâmetro e o parâmetro Permission para conceder direitos a usuários ou grupos especificados.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |