New-SharingPolicy

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-SharingPolicy per creare un criterio di condivisione per regolare il modo in cui gli utenti all'interno dell'organizzazione possono condividere le informazioni relative al contatto e al calendario con gli utenti all'esterno dell'organizzazione. Gli utenti possono condividere queste informazioni solo dopo che la federazione è stata configurata in Exchange. Dopo aver configurato la federazione, gli utenti possono inviare inviti alla condivisione conformi a criteri di condivisione a destinatari esterni in altre organizzazioni Exchange Server 2010 o successive in cui è abilitata la federazione. Un criterio di condivisione per essere effettivo deve essere assegnato ad una cassetta postale. Se una cassetta postale non dispone di un criterio di condivisione specifico assegnato, un criterio predefinito impone il livello di condivisione consentito per questa cassetta postale.

I criteri di condivisione consentono la condivisione stabilita dall'utente e tra utenti delle informazioni di contatto e di calendario con tipi diversi di utenti esterni. I criteri di condivisione consentono agli utenti di condividere sia la disponibilità che le informazioni di contatto (incluse le cartelle Calendario e Contatti) con i destinatari di altre organizzazioni federate di Exchange esterne. Per i destinatari che non si trovano in un'organizzazione federativa esterna o si trovano in organizzazioni non Exchange, i criteri di condivisione consentono la condivisione diretta delle informazioni sul calendario con utenti anonimi tramite l'utilizzo della pubblicazione del calendario Internet.

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

Sintassi

New-SharingPolicy
   [-Name] <String>
   -Domains <MultiValuedProperty>
   [-Confirm]
   [-Default]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È 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-SharingPolicy -Name "Contoso" -Domains 'mail.contoso.com: CalendarSharingFreeBusyDetail, ContactsSharing'

In questo esempio viene creato il criterio di condivisione Contoso per il dominio contoso.com, che è un dominio esterno all'organizzazione. Questo criterio consente agli utenti nel dominio contoso.com di visualizzare informazioni dettagliate sulla disponibilità e i contatti. Per impostazione predefinita, questo criterio è abilitato.

Esempio 2

New-SharingPolicy -Name "SharingPolicy01" -Domains 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusySimple' -Enabled $false -Default $true

In questo esempio viene creato un criterio di condivisione predefinito, che viene applicato a tutte le cassette postali a cui non è stato assegnato un criterio di condivisione. Questo criterio di condivisione SharingPolicy01 si applica a due domini diversi e il criterio di condivisione viene disabilitato.

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

-Default

L'opzione Default consente di specificare che tale criterio di condivisione è quello predefinito per tutte le cassette postali. Con questa opzione non è necessario specificare alcun valore.

Se non è stato applicato alcun criterio di condivisione a una cassetta postale, viene applicato automaticamente il criterio predefinito. Se si desidera disabilitare la condivisione all'interno dell'organizzazione, è possibile disabilitare il criterio predefinito.

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

-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

-Domains

Il parametro Domains consente di specificare i domini e le opzioni di condivisione associate per tali domini nei criteri di condivisione. I valori per questo parametro usano la sintassi di base: 'Domain: SharingPolicyAction'.

È possibile usare i valori seguenti per Domain:

  • Un dominio: ad esempio, mail.contoso.com. Un dominio non include i sottodomini. È necessario configurare ciascun sottodominio separatamente.
  • *: condividere con organizzazioni federate esterne. Ad esempio, un'altra organizzazione di Microsoft 365 o un'organizzazione di Exchange locale.
  • Anonimo: condividere con organizzazioni esterne non federate e utenti con accesso a Internet.

È possibile usare i valori seguenti per SharingPolicyAction:

  • CalendarSharingFreeBusySimple: condividere solo le ore di disponibilità
  • CalendarSharingFreeBusyDetail: Condividere le ore di disponibilità, l'oggetto e la posizione
  • CalendarSharingFreeBusyReviewer: condividere le ore di disponibilità, l'oggetto, la posizione e il corpo del messaggio o dell'elemento del calendario
  • ContactsSharing: Condividi solo i contatti

È possibile specificare più 'Domain: SharingPolicyAction' valori separati da virgole ed è possibile specificare più SharingPolicyAction valori per lo stesso dominio separati da virgole. Ad esempio, 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusyDetail, ContactsSharing'.

Type:MultiValuedProperty
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

-Enabled

Il parametro Enabled consente di specificare se abilitare il nuovo criterio di condivisione. L'input valido per questo parametro è $true o $false. L'impostazione predefinita è $true.

Quando il criterio di condivisione viene disabilitato, gli utenti predisposti all'utilizzo di questo criterio continuano a condividere le informazioni finché non viene eseguito l'Assistente del criterio di condivisione o non vengono rimosse le autorizzazioni sulla cartella condivisa. La frequenza con cui viene eseguito l'Assistente del criterio di condivisione viene assegnata nel cmdlet Set-MailboxServer utilizzando il parametro SharingPolicySchedule.

Type:Boolean
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

-Name

Il parametro Name consente di specificare il nome del nuovo criterio di condivisione.

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

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