Set-MailboxFolderPermission

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet Set-MailboxFolderPermission per modificare le autorizzazioni a livello di cartella per gli utenti presenti nelle cassette postali. Questo cmdlet è differente rispetto a quello Add-MailboxFolderPermission perché modifica le voci di autorizzazione esistenti. Per configurare le impostazioni di pubblicazione o condivisione del calendario di una cassetta postale e rendere le informazioni accessibili agli utenti esterni, usare il cmdlet Set-MailboxCalendarFolder.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Set-MailboxFolderPermission
   [-Identity] <MailboxFolderIdParameter>
   -AccessRights <MailboxFolderAccessRight[]>
   -User <MailboxFolderUserIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-SendNotificationToUser <Boolean>]
   [-SharingPermissionFlags <MailboxFolderPermissionFlags>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

In Exchange Online PowerShell, se non si usano i parametri SendNotificationToUser o SharingPermissionFlags, non vengono apportate modifiche alla funzionalità del cmdlet. Ad esempio, se l'utente è un delegato esistente e si modificano le sue autorizzazioni in Editor senza usare i parametri SendNotificationToUser o SharingPermissionFlags, l'utente rimane un delegato. Tuttavia, se si utilizza il parametro SendNotificationToUser ($true o $false), il parametro SharingPermissionFlags ha il valore predefinito None, che può influire sull'accesso di delegato per gli utenti esistenti. Ad esempio, si modifica un'autorizzazione di un delegato esistente e si usa SendNotificationToUser con il valore $true. L'utente non potrà più essere un delegato e avrà solo autorizzazioni di Editor per la cartella.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner

In questo esempio vengono sovrascritte le autorizzazioni esistenti di Ed relative alla cartella Marketing nella cassetta postale di Ayla. A Ed viene concesso il ruolo di proprietario della cassetta.

Esempio 2

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate -SendNotificationToUser $true

In Exchange Online questo esempio invia di nuovo l'invito alla condivisione a un delegato esistente senza modificarne le autorizzazioni effettive (Ed è già un delegato con autorizzazioni editor per la cassetta postale di Ayla).

Esempio 3

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate

In Exchange Online questo esempio rimuove l'accesso agli elementi privati per un delegato esistente.

Esempio 4

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags None

In Exchange Online questo esempio modifica un delegato del calendario esistente in Editor.

Esempio 5

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor

In Exchange Online questo esempio modifica le autorizzazioni di un utente esistente in Editor senza modificare lo stato del delegato corrente.

Esempio 6

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SendNotificationToUser $false

In Exchange Online questo esempio modifica le autorizzazioni di un utente esistente in Editor e rimuove lo stato del delegato corrente.

Parametri

-AccessRights

Il parametro AccessRights consente di specificare le autorizzazioni da modificare per l'utente presente nella cartella della cassetta postale. I valori che specificano sostituiscono le autorizzazioni esistenti per l'utente della cartella.

È possibile specificare autorizzazioni o ruoli per cartelle individuali, ovvero una combinazione di autorizzazioni. È possibile specificare più autorizzazioni e ruoli separandoli con le virgole.

Sono disponibili le autorizzazioni individuali riportate di seguito:

  • Nessuno: l'utente non ha accesso per visualizzare o interagire con la cartella o il relativo contenuto.
  • CreateItems: l'utente può creare elementi nella cartella specificata.
  • CreateSubfolders: l'utente può creare sottocartelle all'interno della cartella specificata.
  • DeleteAllItems: l'utente può eliminare tutti gli elementi all'interno della cartella specificata.
  • DeleteOwnedItems: l'utente può eliminare soltanto gli elementi che ha creato dalla cartella specificata.
  • EditAllItems: l'utente può modificare tutti gli elementi all'interno della cartella specificata.
  • EditOwnedItems: l'utente può modificare soltanto gli elementi che ha creato nella cartella specificata.
  • FolderContact: l'utente è il contatto per la cartella pubblica specificata.
  • FolderOwner: l'utente è il proprietario della cartella specificata. L'utente può visualizzare la cartella, spostare la cartella e creare sottocartelle. L'utente non può leggere, modificare, eliminare o creare elementi.
  • FolderVisible: l'utente può visualizzare la cartella specificata, ma non può leggere o modificare gli elementi all'interno della cartella pubblica specificata.
  • ReadItems: l'utente può leggere elementi all'interno della cartella specificata.

I ruoli disponibili, insieme alle autorizzazioni che assegnano, sono descritti nell'elenco seguente:

  • Autore: CreateItems, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • Collaboratore: CreateItems, FolderVisible
  • Editor: CreateItems, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • NonEditingAuthor: CreateItems, DeleteOwnedItems, FolderVisible, ReadItems
  • Proprietario: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible, ReadItems
  • PublishingAuthor: CreateItems, CreateSubfolders, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • PublishingEditor: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • Revisore: FolderVisible, ReadItems

I seguenti ruoli vengono applicati in modo specifico alle cartelle di calendario:

  • AvailabilityOnly: visualizza solo i dati disponibili
  • LimitedDetails: visualizza i dati disponibili con l'oggetto e la posizione

Quando il ruolo Editor viene applicato alle cartelle del calendario, i delegati possono accettare o rifiutare le riunioni selezionando manualmente la convocazione di riunione nella cassetta postale. In Exchange Online, per inviare convocazioni di riunione ai delegati in cui possono accettare o rifiutare le riunioni, usare anche il parametro SharingPermissionFlags con il valore Delegate.

Type:MailboxFolderAccessRight[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Il parametro Identity consente di specificare la cassetta postale e la cartella di destinazione. La sintassi è MailboxID:\ParentFolder[\SubFolder].

Per il valore di MailboxID, è possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

I valori di esempio per questo parametro sono john@contoso.com:\Calendar o John:\Inbox\Reports.

Type:MailboxFolderIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SendNotificationToUser

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro SendNotificationToUser consente di specificare se inviare un invito alla condivisione all'utente quando si modificano le autorizzazioni del calendario. Il messaggio sarà un normale invito di condivisione del calendario che può essere accettato dal destinatario. I valori validi sono:

  • $true: Viene inviato un invito alla condivisione.
  • $false: Non viene inviato un invito alla condivisione. Questo è il valore predefinito.

Questo parametro si applica solo alle cartelle del calendario e può essere usato solo con i valori del parametro AccessRights seguenti:

  • AvailabilityOnly
  • LimitedDetails
  • Reviewer
  • Editor
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SharingPermissionFlags

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro SharingPermissionFlags consente di assegnare le autorizzazioni di delegato per il calendario. Questo parametro si applica solo alle cartelle del calendario e può essere utilizzato solo quando il valore del parametro AccessRights è Editor. I valori validi sono:

  • None: Rimuove le autorizzazioni del delegato e aggiorna la regola dei messaggi di riunione affinché l'utente smetta di ricevere inviti alle riunioni e risposte per la cassetta postale. Questo è il valore predefinito quando si usa il parametro SendNotificationToUser senza specificare un valore per il parametro SharingPermissionFlags.
  • Delegate: L'utente è un delegato per il calendario, ovvero riceve inviti alle riunioni e risposte. Se non sono presenti altri delegati, questo valore crea la regola dei messaggi di riunione. Se sono presenti delegati, l'utente viene aggiunto alla regola dei messaggi di riunione senza modificare i messaggi di delegato inviati.
  • CanViewPrivateItems: L'utente può accedere a elementi privati nel calendario. È necessario utilizzare questo valore con il valore Delegate.

È possibile specificare più valori separati da virgole.

Type:MailboxFolderPermissionFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-User

Il parametro User consente di specificare la cassetta postale, l'utente di posta elettronica o il gruppo di sicurezza abilitato alla posta elettronica (entità di sicurezza) a cui sono concesse le autorizzazioni della cartella della cassetta postale. È possibile utilizzare qualsiasi valore che identifichi il gruppo o l'utente in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID
Type:MailboxFolderUserIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.