New-OrganizationRelationship

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-OrganizationRelationship per creare le relazioni dell'organizzazione. Le relazioni dell'organizzazione definiscono le impostazioni usate con le organizzazioni di Exchange esterne per accedere alle informazioni sulla disponibilità del calendario o per spostare le cassette postali tra server Exchange locali e Exchange Online come parte delle distribuzioni ibride.

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

Sintassi

New-OrganizationRelationship
   [-Name] <String>
   -DomainNames <MultiValuedProperty>
   [-ArchiveAccessEnabled <Boolean>]
   [-Confirm]
   [-DeliveryReportEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-FreeBusyAccessEnabled <Boolean>]
   [-FreeBusyAccessLevel <FreeBusyAccessLevel>]
   [-FreeBusyAccessScope <GroupIdParameter>]
   [-MailboxMoveCapability <MailboxMoveCapability>]
   [-MailboxMoveEnabled <Boolean>]
   [-MailboxMovePublishedScopes <MultiValuedProperty>]
   [-MailTipsAccessEnabled <Boolean>]
   [-MailTipsAccessLevel <MailTipsAccessLevel>]
   [-MailTipsAccessScope <GroupIdParameter>]
   [-OAuthApplicationId <String>]
   [-OrganizationContact <SmtpAddress>]
   [-PhotosEnabled <Boolean>]
   [-TargetApplicationUri <Uri>]
   [-TargetAutodiscoverEpr <Uri>]
   [-TargetOwaURL <Uri>]
   [-TargetSharingEpr <Uri>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È necessario creare una relazione di trust federativa prima di creare una relazione di organizzazione. Per altre informazioni, vedere Federazione.

È 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

Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails

In questo esempio viene creata una relazione di organizzazione con Contoso. Il nome di dominio a cui eseguire la connessione è contoso.com. Vengono utilizzate le seguenti impostazioni:

Opzioni sulla disponibilità abilitate.

L'organizzazione richiedente riceve l'ora, l'oggetto e le informazioni sulla posizione dall'organizzazione di destinazione.

In questo esempio si tenta di ottenere automaticamente le informazioni di configurazione dell'organizzazione esterna utilizzando i nomi di dominio indicati nel comando Get-FederationInformation. Se si utilizza questo metodo per creare la relazione tra organizzazioni, è prima necessario accertarsi di aver creato un identificatore di organizzazione utilizzando il cmdlet Set-FederationOrganizationIdentifier.

Esempio 2

New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "mail.fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"

In questo esempio viene creata la relazione di organizzazione con Fourth Coffee utilizzando le seguenti impostazioni. In questo esempio sono disponibili le impostazioni di connessione all'organizzazione esterna.

Il dominio a cui connettersi è mail.fourthcoffee.com.

L'URL dell'applicazione per i servizi Web di Exchange è mail.fourthcoffee.com.

L'URL di individuazione automatica è https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity.

Opzioni sulla disponibilità abilitate.

L'organizzazione richiedente riceve solo le informazioni sulla disponibilità con l'ora.

Parametri

-ArchiveAccessEnabled

Il parametro ArchiveAccessEnabled consente di specificare se la relazione tra organizzazioni è stata configurata per fornire l'accesso all'archivio remoto. I valori validi sono:

  • $true: l'organizzazione esterna fornisce l'accesso remoto agli archivi delle cassette postali.
  • $false: l'organizzazione esterna non fornisce l'accesso remoto agli archivi delle cassette postali. Questo è il valore predefinito.
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, Exchange Online Protection

-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

-DeliveryReportEnabled

Il parametro DeliveryReportEnabled consente di specificare se i report di recapito devono essere condivisi in questa relazione tra organizzazioni. I valori validi sono:

  • $true: i report di recapito devono essere condivisi sulla relazione dell'organizzazione. Questo valore indica che l'organizzazione ha accettato di condividere tutti i report di recapito con l'organizzazione esterna e la relazione dell'organizzazione deve essere usata per recuperare le informazioni sui report di recapito dall'organizzazione esterna.
  • $false: i report di recapito non devono essere condivisi sulla relazione dell'organizzazione. Questo è il valore predefinito

Affinché il rilevamento dei messaggi funzioni in uno scenario exchange cross-premise, questo parametro deve essere impostato su $true su entrambi i lati della relazione dell'organizzazione. Se il valore di questo parametro è impostato su $false in uno o entrambi i lati della relazione tra organizzazioni, la verifica dei messaggi tra le organizzazioni non funziona in entrambe le direzioni.

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

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

-DomainNames

Il parametro DomainNames consente di specificare i domini SMTP dell'organizzazione esterna. È possibile specificare più domini separati da virgole (ad esempio, "contoso.com","northamerica.contoso.com"), limitati a 238 domini in una richiesta.

Type:MultiValuedProperty
Position:Named
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, Exchange Online Protection

-Enabled

Il parametro Enabled consente di specificare se abilitare la relazione dell'organizzazione. I valori validi sono:

  • $true: la relazione dell'organizzazione è abilitata. Questo è il valore predefinito.
  • $false: la relazione dell'organizzazione è disabilitata. Questo valore interrompe completamente la condivisione per la relazione dell'organizzazione.
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, Exchange Online Protection

-FreeBusyAccessEnabled

Il parametro FreeBusyAccessEnabled consente di specificare se questa relazione tra organizzazioni deve essere utilizzata per recuperare informazioni sulla disponibilità dall'organizzazione esterna. I valori validi sono:

  • $true: le informazioni sulla disponibilità vengono recuperate dall'organizzazione esterna.
  • $false: le informazioni sulla disponibilità non vengono recuperate dall'organizzazione esterna. Questo è il valore predefinito.

Controllare l'ambito e il livello di accesso di disponibilità utilizzando i parametri FreeBusyAccessLevel e FreeBusyAccessScope.

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

-FreeBusyAccessLevel

Il parametro FreeBusyAccessLevel consente di specificare la quantità massima di dettagli restituiti all'organizzazione richiedente. I valori validi sono:

  • Nessuno: nessun accesso alla disponibilità.
  • AvailabilityOnly: accesso alla disponibilità solo con tempo.
  • LimitedDetails: accesso alla disponibilità con ora, oggetto e posizione.

Questo parametro ha senso solo quando il valore del parametro FreeBusyAccessEnabled è impostato su $true.

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

-FreeBusyAccessScope

Il parametro FreeBusyAccessScope consente di specificare un gruppo di protezione abilitato alla posta nell'organizzazione interna contenente gli utenti per cui è possibile accedere alle informazioni sulla disponibilità da un'organizzazione esterna. È possibile utilizzare qualsiasi valore che identifichi il gruppo in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • Nome distinto (DN)
  • GUID

Questo parametro ha senso solo quando il valore del parametro FreeBusyAccessEnabled è impostato su $true.

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

-MailboxMoveCapability

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro MailboxMoveCapability viene usato nelle migrazioni delle cassette postali tra tenant. I valori validi sono:

  • Inbound
  • In uscita
  • RemoteInbound
  • RemoteOutbound

Per altre informazioni, vedere Migrazione delle cassette postali tra tenant.

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

-MailboxMoveEnabled

Il parametro MailboxMoveEnabled consente di specificare se la relazione tra organizzazioni consente lo spostamento delle cassette postali da o per l'organizzazione esterna. I valori validi sono:

  • $true: sono consentiti gli spostamenti delle cassette postali da o verso l'organizzazione esterna.
  • $false: le cassette postali spostate da o verso l'organizzazione esterna non sono consentite. Questo è il valore predefinito.
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, Exchange Online Protection

-MailboxMovePublishedScopes

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro MailboxMovePublishedScopes viene usato nelle migrazioni delle cassette postali tra tenant per specificare i gruppi di sicurezza abilitati alla posta elettronica i cui membri possono eseguire la migrazione. È possibile utilizzare qualsiasi valore che identifichi il gruppo in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • Nome distinto (DN)
  • GUID

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni, vedere Migrazione delle cassette postali tra tenant.

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

-MailTipsAccessEnabled

Il parametro MailTipsAccessEnabled consente di specificare se i Suggerimenti messaggio per gli utenti nell'organizzazione vengono restituiti in questa relazione tra organizzazioni. I valori validi sono:

  • $true: i suggerimenti messaggio per gli utenti dell'organizzazione vengono restituiti sulla relazione dell'organizzazione.
  • $false: i suggerimenti messaggio per gli utenti dell'organizzazione non vengono restituiti sulla relazione dell'organizzazione. Questo è il valore predefinito.

Controllare il livello di accesso di Suggerimenti messaggio tramite il parametro MailTipsAccessLevel.

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

-MailTipsAccessLevel

Il parametro MailTipsAccessLevel consente di specificare il livello dei dati di Suggerimenti messaggio condivisi esternamente in questa relazione tra organizzazioni. I valori consentiti per questo parametro sono i seguenti:

  • Tutto: vengono restituiti tutti i suggerimenti messaggio, ma i destinatari dell'organizzazione remota vengono considerati esterni. Per i Suggerimenti messaggio di risposta automatica, viene restituito il messaggio di risposta automatica esterno.
  • Limitato: vengono restituiti solo i suggerimenti messaggio che potrebbero impedire un report di mancato recapito o una risposta automatica. I Suggerimenti messaggio personalizzati, relativi a un pubblico esteso o a un destinatario moderato non vengono restituiti.
  • Nessuno: nessun suggerimento messaggio viene restituito all'organizzazione remota. Questo è il valore predefinito.

Questo parametro ha senso solo quando il valore del parametro MailTipsAccessEnabled è impostato su $true.

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

-MailTipsAccessScope

Il parametro MailTipsAccessScope consente di specificare un gruppo di protezione abilitato alla posta nell'organizzazione interna contenente gli utenti per cui è possibile accedere alle informazioni sulla disponibilità da un'organizzazione esterna. È possibile utilizzare qualsiasi valore che identifichi il gruppo in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • Nome distinto (DN)
  • GUID

Il valore predefinito è vuoto ($null) e indica che nessun gruppo è specificato.

Se si utilizza questo parametro, i Suggerimenti messaggio specifici per il destinatario vengono restituiti solo per i destinatari che sono membri del gruppo specificato. I Suggerimenti messaggio specifici per il destinatario sono i seguenti:

  • Risposta automatica
  • Cassetta postale piena
  • Personalizzato

Se non si utilizza questo parametro, i Suggerimenti messaggio specifici per il destinatario vengono restituiti per tutti i destinatari nell'organizzazione.

Questa restrizione si applica solo alle cassette postali, agli utenti di posta e ai contatti di posta. Non si applica ai gruppi di distribuzione.

Type:GroupIdParameter
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 univoco della relazione di organizzazione. La lunghezza massima è 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

-OAuthApplicationId

Questo parametro è disponibile solamente nel servizio basato su cloud.

OAuthApplicationId viene usato nelle migrazioni delle cassette postali tra tenant per specificare l'ID applicazione dell'app per la migrazione delle cassette postali a cui è stato concesso il consenso. Per altre informazioni, vedere Migrazione delle cassette postali tra tenant.

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

-OrganizationContact

Il parametro OrganizationContact consente di specificare l'indirizzo di posta elettronica che può essere usato per contattare l'organizzazione esterna, administrator@fourthcoffee.comad esempio .

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

-PhotosEnabled

Il parametro PhotosEnabled consente di specificare se le foto per gli utenti dell'organizzazione interna vengono restituiti in questa relazione tra organizzazioni. I valori validi sono:

  • $true: le foto per gli utenti dell'organizzazione vengono restituite sulla relazione dell'organizzazione.
  • $false: le foto per gli utenti di questa organizzazione non vengono restituite sulla relazione dell'organizzazione. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-TargetApplicationUri

Il parametro TargetApplicationUri consente di specificare l'URI (Uniform Resource Identifier) di destinazione dell'organizzazione esterna. Il parametro TargetApplicationUri viene specificato da Exchange quando si richiede un token delegato per l'organizzazione esterna per recuperare informazioni sulla disponibilità, ad esempio mail.contoso.com.

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

-TargetAutodiscoverEpr

Il parametro TargetAutodiscoverEpr specifica l'URL di individuazione automatica di Servizi Web Exchange per l'organizzazione esterna, ad esempio https://contoso.com/autodiscover/autodiscover.svc/wssecurity. Exchange usa il servizio di individuazione automatica per rilevare automaticamente l'endpoint del server Exchange corretto da usare per le richieste esterne.

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

-TargetOwaURL

Il parametro TargetOwaURL specifica l'URL Outlook sul web (in precedenza Outlook Web App) dell'organizzazione esterna definita nella relazione dell'organizzazione. Viene usato per Outlook sul web reindirizzamento in uno scenario di Exchange cross-premise. La configurazione di questo attributo consente agli utenti dell'organizzazione di usare l'URL di Outlook sul web corrente per accedere a Outlook sul web nell'organizzazione esterna.

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

-TargetSharingEpr

Il parametro TargetSharingEpr specifica l'URL dei servizi Web Exchange di destinazione per l'organizzazione esterna.

Se si usa questo parametro, questo URL viene sempre usato per raggiungere il server Exchange esterno. L'URL specificato dal parametro TargetAutodiscoverEpr non viene usato per individuare il server Exchange esterno.

Type:Uri
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.