Add-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.

Utilizzare il cmdlet Add-MailboxFolderPermission per aggiungere le autorizzazioni di un utente a livello di cartella nelle cassette postali.

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

Sintassi

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

Descrizione

Per modificare le autorizzazioni assegnate all'utente in una cartella della cassetta postale, utilizzare il cmdlet Set-MailboxFolderPermission. Per rimuovere tutte le autorizzazioni assegnate all'utente in una cartella della cassetta postale, utilizzare il cmdlet Remove-MailboxFolderPermission.

È 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

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

In questo esempio viene concesso il ruolo di proprietario a Ed all'interno della cartella Marketing della cassetta postale di Ayla.

Esempio 2

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

In Exchange Online questo esempio aggiunge Julia come delegato del calendario alla cassetta postale di Ayla, ma senza accesso agli elementi privati.

Esempio 3

Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User laura@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate,CanViewPrivateItems

In Exchange Online questo esempio aggiunge Laura come delegato del calendario alla cassetta postale di Ayla con accesso agli elementi privati.

Parametri

-AccessRights

Il parametro AccessRights consente di specificare le autorizzazioni che si desidera aggiungere all'utente presente nella cartella della cassetta postale.

È 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 all'interno della 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 elementi, modificare elementi, eliminare elementi 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 aggiungono autorizzazioni per il 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: Non ha alcun effetto. Questo è il valore predefinito.
  • 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.

Nota: non è possibile configurare l'impostazione Recapito delle convocazioni di riunione indirizzate all'utente e alle risposte alle convocazioni di riunione in cui sono organizzatore di Outlook in PowerShell. È tuttavia possibile configurare l'impostazione usando Exchange Web Services (EWS). Per altre informazioni, vedere MeetingRequestsDeliveryScope Enum.

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 specifica l'utente a cui è concessa l'autorizzazione per la cartella della cassetta postale. I valori validi sono entità di sicurezza abilitate alla posta elettronica (gli account o i gruppi abilitati alla posta elettronica dispongono di identificatori di sicurezza o SID ai quali possono essere assegnate autorizzazioni). Ad esempio:

  • Cassette postali di tipo utente
  • Utenti di posta elettronica
  • Gruppi di sicurezza abilitati alla posta elettronica

È 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.