New-AIPCustomPermissions

Riferimento

Modulo:: AzureInformationProtection

Rilevante per: Solo client di etichettatura unificata AIP

Crea un criterio di protezione ad hoc per le autorizzazioni personalizzate.

Sintassi

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

Descrizione

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

Se l'etichetta applicata viene configurata per le impostazioni di protezione, le autorizzazioni personalizzate dei criteri di protezione ad hoc sostituiscono 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-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

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

Non viene visualizzato alcun output per questo comando.

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

PS C:\> $permissions = New-AIPCustomPermissions -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 organizzazioni diverse 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 permissions, che può quindi essere usata per applicare questa protezione a un file o a un file.

Non viene 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 con privilegi avanzati possono sempre accedere al file, anche dopo il raggiungimento del periodo di scadenza.

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 che vengono in genere usati insieme. Usare questo parametro e il parametro Users per concedere diritti di utilizzo agli utenti specificati.

Per verificare quali diritti di utilizzo sono inclusi in ognuno dei livelli di autorizzazione, 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 i diritti per l'uso del file o dei file. Usare questo parametro e il parametro Permission per concedere diritti a utenti o gruppi specificati.

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

Input

None

Output

System.Object

Set-AIPFileLabel