Condividi tramite


New-CustomPermissions

Crea criteri di protezione ad hoc per le autorizzazioni personalizzate.

Sintassi

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

Descrizione

Il cmdlet New-CustomPermissions crea un oggetto criteri di protezione ad hoc per autorizzazioni personalizzate archiviate come variabile e quindi usare per proteggere un file o file quando si esegue il cmdlet di etichettatura Set-FileLabel.

Se l'etichetta applicata viene configurata per le impostazioni di protezione, le autorizzazioni personalizzate dei criteri di protezione ad hoc sostituiscino le impostazioni di protezione dall'etichetta.

Esempio

Esempio 1 - Creare un oggetto criteri di protezione ad hoc per un singolo utente

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

Questo comando crea un oggetto criteri di protezione ad hoc che concede agli utenti1 i diritti di utilizzo contoso.com dalle autorizzazioni Revisore e archivia questo criterio in una variabile denominata autorizzazioni. Questo criterio di protezione ad hoc può quindi essere usato per applicare la protezione a un file o file.

Non è visualizzato alcun output per questo comando.

Esempio 2: Creare un oggetto criteri di protezione ad hoc per più utenti e che ha una data di scadenza

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

Questo comando crea un oggetto criteri di protezione ad hoc che concede agli utenti di diversi organizzazioni i diritti di utilizzo delle autorizzazioni Revisore e applica anche una data di scadenza. L'oggetto criteri di protezione ad hoc viene archiviato in una variabile denominata autorizzazioni, che può quindi essere usata per applicare questa protezione a un file o file.

Non è visualizzato alcun output per questo comando.

Parametri

-ExpirationDate

Specifica una data di scadenza per i criteri di protezione ad hoc.

Dopo questa data di scadenza, gli utenti specificati non potranno più accedere al file o ai file. Tuttavia, il proprietario e un utente super possono sempre accedere al file, anche dopo il periodo di scadenza raggiunto.

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

-Permissions

Specifica un livello di autorizzazioni che raggruppa i diritti di utilizzo usati in genere. Usare questo parametro e il parametro Users per concedere diritti di utilizzo agli utenti specificati.

Per verificare quali singoli diritti di utilizzo sono inclusi in ognuno dei livelli di autorizzazioni, vedere Diritti inclusi nei livelli di autorizzazione.

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

-Users

Specifica gli utenti che avranno diritti per l'uso del file o dei file. Usare questo parametro e il parametro Permission per concedere diritti agli utenti o ai gruppi specificati.

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

Input

None

Output

System.Object