New-RoleAssignmentPolicy

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 New-RoleAssignmentPolicy per creare criteri di assegnazione dei ruoli di gestione nell'organizzazione.

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

Sintassi

New-RoleAssignmentPolicy
   [-Name] <String>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-IsDefault]
   [-Roles <RoleIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Quando si crea un criterio di assegnazione, è possibile assegnarlo agli utenti utilizzando i cmdlet New-Mailbox, Set-Mailbox o Enable-Mailbox. Se si stabilisce che il nuovo criterio di assegnazione è il criterio di assegnazione predefinito, verrà assegnato a tutte le nuove cassette postali prive di un criterio di assegnazione specifico.

È possibile aggiungere ruoli di gestione al nuovo criterio di assegnazione in fase di creazione, oppure è possibile creare prima il criterio di assegnazione e successivamente aggiungere i ruoli. È necessario assegnare almeno un ruolo di gestione al nuovo criterio di assegnazione perché possa applicare le autorizzazioni a una cassetta postale. Se non sono stati assegnati ruoli al nuovo criterio di assegnazione, gli utenti assegnati ad esso non potranno gestire la configurazione della loro cassetta postale. Per assegnare un ruolo di gestione dopo aver creato il criterio di assegnazione, utilizzare il cmdlet New-ManagementRoleAssignment. Per ulteriori informazioni, vedere Gestire i criteri di assegnazione dei ruoli.

Per altre informazioni sui criteri di assegnazione, vedere Informazioni sui criteri di assegnazione dei ruoli di gestione.

È 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

New-RoleAssignmentPolicy -Name "End User Policy"

Set-Mailbox -Identity Joe -RoleAssignmentPolicy "End User Policy"

In questo esempio viene creato un criterio di assegnazione. Un criterio di assegnazione. dopo essere stato creato, può essere assegnato a una cassetta postale utilizzando il cmdlet Set-Mailbox.

Esempio 2

New-RoleAssignmentPolicy -Name "Default End User Policy" -IsDefault

In questo esempio viene creato un criterio di assegnazione utilizzando l'opzione IsDefault.

Esempio 3

New-RoleAssignmentPolicy -Name "Limited End User Policy" -Roles "MyPersonalInformation", "MyDistributionGroupMembership", "MyVoiceMail" -IsDefault

Get-Mailbox -ResultSize Unlimited | Set-Mailbox -RoleAssignmentPolicy "Limited End User Policy"

Con questo esempio viene creato un criterio di assegnazione che consente agli utenti di modificare le loro informazioni personali, gestire le rispettive appartenenze ai gruppi di distribuzione e gestire la loro segreteria telefonica. Il nuovo criterio di assegnazione viene creato come criterio di assegnazione predefinito. Di conseguenza, tutte le cassette postali esistenti vengono configurate per utilizzare il nuovo criterio di assegnazione.

Per prima cosa, il nuovo criterio di assegnazione viene creato e impostato come nuovo criterio di assegnazione predefinito.

Poiché l'impostazione della nuova assegnazione di ruolo come predefinita si applica solo alle nuove cassette postali o cassette postali spostate dalle versioni precedenti di Exchange, il cmdlet Set-Mailbox viene usato per configurare i nuovi criteri di assegnazione in tutte le cassette postali esistenti.

Parametri

-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, Exchange Online Protection

-Description

Il parametro Description consente di specificare la descrizione visualizzata quando i criteri di assegnazione dei ruoli vengono visualizzati utilizzando il cmdlet Get-RoleAssignmentPolicy. Racchiudere la descrizione tra virgolette (").

Type:String
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, Exchange Online Protection

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

Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.

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

-IsDefault

L'opzione IsDefault consente di impostare il criterio di assegnazione come criterio di assegnazione predefinito. Con questa opzione non è necessario specificare alcun valore.

Alle nuove cassette postali o cassette postali spostate dalle versioni precedenti di Exchange vengono assegnati i criteri di assegnazione predefiniti quando non viene specificato un criterio di assegnazione esplicito.

L'impostazione di un criterio di assegnazione predefinito non modifica le assegnazioni dei ruoli nelle cassette postali esistenti. Per modificare i criteri di assegnazione per le cassette postali esistenti, utilizzare il cmdlet Set-Mailbox.

Type:SwitchParameter
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, Exchange Online Protection

-Name

Il parametro Name consente di specificare il nome del nuovo criterio di assegnazione. Se il nome dei criteri di assegnazione contiene spazi, racchiudere il nome tra virgolette ("). La lunghezza massima del nome è di 64 caratteri.

Type:String
Position:1
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, Exchange Online Protection

-Roles

Il parametro Roles consente di specificare i ruoli di gestione da assegnare al criterio di assegnazione dei ruoli in fase di creazione. Se un nome di ruolo contiene spazi, racchiudere il nome tra virgolette (""). Se si desidera assegnare più di un ruolo, separare i nomi di ruolo con virgole.

Per un elenco dei ruoli di gestione predefiniti che è possibile assegnare a un gruppo di ruoli, vedere Ruoli di gestione predefiniti.

Type:RoleIdParameter[]
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, Exchange Online Protection

-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, Exchange Online Protection

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.