Set-OrganizationRelationship

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Set-OrganizationRelationship zum Ändern von vorhandenen Organisationsbeziehungen. Organisationsbeziehungen definieren die Einstellungen, die mit externen Exchange-Organisationen verwendet werden, um im Rahmen von Hybridbereitstellungen auf Frei/Gebucht-Kalenderinformationen zuzugreifen oder Postfächer zwischen lokalen Exchange-Servern und Exchange Online zu verschieben.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

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

Beschreibung

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-OrganizationRelationship -Identity "Fourth Coffee" -FreeBusyAccessLevel LimitedDetails

In diesem Beispiel wird die Frei/Gebucht-Zugriffsebene in LimitedDetails geändert, wozu Zeit, Betreff und Ort zählen.

Beispiel 2

Set-OrganizationRelationship -Identity "Contoso" -Enabled $false

In diesem Beispiel wird die Organisationsbeziehung mit "Contoso" deaktiviert

Parameter

-ArchiveAccessEnabled

Der Parameter ArchiveAccessEnabled gibt an, ob die Organisationsbeziehung konfiguriert wurde, um Remotearchivzugriff bereitzustellen. Gültige Werte sind:

  • $true: Die externe Organisation bietet Remotezugriff auf Postfacharchive.
  • $false: Die externe Organisation bietet keinen Remotezugriff auf Postfacharchive. Dies ist der Standardwert.
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

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
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

Der Parameter DeliveryReportEnabled gibt an, ob Zustellberichte über die Organisationsbeziehung freigegeben werden. Gültige Werte sind:

  • $true: Übermittlungsberichte sollten über die Organisationsbeziehung freigegeben werden. Dieser Wert bedeutet, dass die Organisation zugestimmt hat, alle Übermittlungsberichte für die externe Organisation zu teilen, und die Organisationsbeziehung sollte verwendet werden, um Übermittlungsberichtsinformationen aus der externen Organisation abzurufen.
  • $false: Übermittlungsberichte sollten nicht über die Organisationsbeziehung freigegeben werden. Dies ist der Standardwert.

Damit die Nachrichtennachverfolgung in einem standortübergreifenden Exchange-Szenario funktioniert, muss dieser Parameter auf beiden Seiten der Organisationsbeziehung auf $true festgelegt werden. Wenn der Wert des Parameters auf einer oder beiden Seiten der Organisationsbeziehung auf $false festgelegt ist, funktioniert die Nachverfolgung zwischen den Organisationen weder in die eine noch in die andere Richtung.

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: 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

Der Parameter DomainNames gibt die SMTP-Domänen der externen Organisation an. Sie können mehrere Domänen getrennt durch Kommas (z. B. "contoso.com","northamerica.contoso.com") angeben.

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

-Enabled

Der Parameter Enabled gibt an, ob die Organisationsbeziehung aktiviert wird. Gültige Werte sind:

  • $true: Die Organisationsbeziehung ist aktiviert. Dies ist der Standardwert.
  • $false: Die Organisationsbeziehung ist deaktiviert. Durch diesen Wert wird die Freigabe für die Organisationsbeziehung vollständig ausgesetzt.
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

-Force

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

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

-FreeBusyAccessEnabled

Der Parameter FreeBusyAccessEnabled gibt an, ob die Organisationsbeziehung zum Abrufen von Frei/Gebucht-Informationen aus der externen Organisation verwendet werden soll. Gültige Werte sind:

  • $true: Frei/Gebucht-Informationen werden aus der externen Organisation abgerufen.
  • $false: Frei/Gebucht-Informationen werden nicht aus der externen Organisation abgerufen. Dies ist der Standardwert.

Sie steuern die Frei/Gebucht-Zugriffsebene und den entsprechenden Umfang mithilfe der FreeBusyAccessLevel- und FreeBusyAccessScope-Parameter.

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

Der Parameter FreeBusyAccessLevel gibt den maximalen Detailumfang an, der an die anfordernde Organisation zurückgegeben wird. Gültige Werte sind:

  • Keine: Kein Frei/Gebucht-Zugriff.
  • AvailabilityOnly: Frei/Gebucht-Zugriff nur mit Zeit.
  • LimitedDetails: Frei/Gebucht-Zugriff mit Zeit, Betreff und Standort.

Dieser Parameter ist nur von Bedeutung, wenn der Wert von Parameter FreeBusyAccessEnabled$true lautet.

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

Der Parameter FreeBusyAccessScope gibt eine E-Mail-aktivierte Sicherheitsgruppe in der internen Organisation an, zu der Benutzer gehören, auf deren Frei/Gebucht-Informationen von einer externen Organisation zugegriffen werden kann. Sie können einen beliebigen Wert verwenden, der die Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • GUID

Dieser Parameter ist nur von Bedeutung, wenn der Wert von Parameter FreeBusyAccessEnabled$true lautet.

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

-Identity

Der Parameter Identity gibt die Beziehung an, die geändert werden soll. Sie können jeden Wert angeben, durch den die Unternehmensbeziehung eindeutig identifiziert wird. Beispiel:

  • Name
  • Kanonischer Name
  • GUID
Type:OrganizationRelationshipIdParameter
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, Exchange Online Protection

-MailboxMoveCapability

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter MailboxMoveCapability wird bei mandantenübergreifenden Postfachmigrationen verwendet. Gültige Werte sind:

  • Eingehend
  • Ausgehend
  • RemoteInbound
  • RemoteOutbound

Weitere Informationen finden Sie unter Mandantenübergreifende Postfachmigration.

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

Der Parameter MailboxMoveEnabled gibt an, ob die Organisationsbeziehung das Verschieben von Postfächern in die externe Organisation ermöglicht. Gültige Werte sind:

  • $true: Postfachverschiebungen in oder aus der externen Organisation sind zulässig.
  • $false: Postfachverschiebungen von der externen Organisation nach sind nicht zulässig. Dies ist der Standardwert.
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

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter MailboxMovePublishedScopes wird bei mandantenübergreifenden Postfachmigrationen verwendet, um die E-Mail-aktivierten Sicherheitsgruppen anzugeben, deren Mitglieder migriert werden dürfen. Sie können einen beliebigen Wert verwenden, der die Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • GUID

Verwenden Sie die folgende Syntax, um mehrere Werte einzugeben und vorhandene Einträge zu überschreiben: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um einen oder mehrere Werte ohne Auswirkungen auf vorhandene Einträge hinzuzufügen oder zu entfernen: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Weitere Informationen finden Sie unter Mandantenübergreifende Postfachmigration.

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

Der Parameter MailTipsAccessEnabled gibt an, ob E-Mail-Infos für Benutzer in dieser Organisation über diese Organisationsbeziehung zurückgegeben werden. Gültige Werte sind:

  • $true: E-Mail-Infos für Benutzer in dieser Organisation werden über die Organisationsbeziehung zurückgegeben.
  • $false: E-Mail-Infos für Benutzer in dieser Organisation werden nicht über die Organisationsbeziehung zurückgegeben. Dies ist der Standardwert.

Sie steuern die Berechtigungsebene für E-Mail-Infos mit dem MailTipsAccessLevel-Parameter.

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

Der Parameter MailTipsAccessLevel gibt die Ebene der E-Mail-Infos an, die extern über diese Organisationsbeziehung freigegeben werden. Dieser Parameter kann die folgenden Werte annehmen:

  • Alle: Alle E-Mail-Infos werden zurückgegeben, aber die Empfänger in der Remoteorganisation werden als extern betrachtet. Als E-Mail-Info zur automatischen Antwort wird die externe automatische Antwortnachricht zurückgegeben.
  • Eingeschränkt: Es werden nur die E-Mail-Infos zurückgegeben, die einen Unzustellbarkeitsbericht (Non-Delivery Report, NDR) oder eine automatische Antwort verhindern könnten. Benutzerdefinierte E-Mail-Infos sowie die E-Mail-Infos zu großen Benutzergruppen und moderierten Empfängern werden nicht zurückgegeben.
  • Keine: Es werden keine E-Mail-Infos an die Remoteorganisation zurückgegeben. Dies ist der Standardwert.

Dieser Parameter ist nur von Bedeutung, wenn der Wert von Parameter MailTipsAccessEnabled$true lautet.

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

Der Parameter MailTipsAccessScope gibt eine E-Mail-aktivierte Sicherheitsgruppe in der internen Organisation an, zu der Benutzer gehören, auf deren Frei/Gebucht-Informationen von einer externen Organisation zugegriffen werden kann. Sie können einen beliebigen Wert verwenden, der die Gruppe eindeutig identifiziert. Zum Beispiel:

  • Name
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • GUID

Der Standardwert ist leer ($null), d. h. es ist keine Gruppe angegeben.

Wird dieser Parameter verwendet, werden empfängerspezifische E-Mail-Infos nur für Empfänger zurückgegeben, die Mitglieder der angegebenen Gruppe sind. Die empfängerspezifischen E-Mail-Infos lauten:

  • Automatische Antwort
  • Postfach voll
  • Benutzerdefiniert

Wird dieser Parameter nicht verwendet, werden empfängerspezifische E-Mail-Infos für alle Empfänger in der Organisation zurückgegeben.

Diese Einschränkung gilt nur für Postfächer, E-Mail-Benutzer und E-Mail-Kontakte. Sie gilt nicht für Verteilergruppen.

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

Der Parameter Name gibt den eindeutigen Namen der Organisationsbeziehung an. Die Höchstlänge beträgt 64 Zeichen.

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

-OAuthApplicationId

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Die OAuthApplicationId wird bei mandantenübergreifenden Postfachmigrationen verwendet, um die Anwendungs-ID der Postfachmigrations-App anzugeben, der Sie zugestimmt haben. Weitere Informationen finden Sie unter Mandantenübergreifende Postfachmigration.

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

Der Parameter OrganizationContact gibt die E-Mail-Adresse an, die zum Kontaktieren der externen Organisation verwendet werden kann (z. B administrator@fourthcoffee.com. ).

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

Der Parameter PhotosEnabled gibt an, ob Fotos für Benutzer in der internen Organisation über diese Organisationsbeziehung zurückgegeben werden. Gültige Werte sind:

  • $true: Fotos für Benutzer in dieser Organisation werden über die Organisationsbeziehung zurückgegeben.
  • $false: Fotos für Benutzer in dieser Organisation werden nicht über die Organisationsbeziehung zurückgegeben. Dies ist der Standardwert.
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

Der Parameter TargetApplicationUri gibt den Ziel-URI (Uniform Resource Identifier) der externen Organisation an. Der Parameter TargetApplicationUri wird von Exchange angegeben, wenn ein delegiertes Token zum Abrufen von Frei/Gebucht-Informationen angefordert wird, z. B. 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

Der Parameter TargetAutodiscoverEpr gibt die AutoErmittlungs-URL der Exchange-Webdienste für die externe Organisation an, z. B https://contoso.com/autodiscover/autodiscover.svc/wssecurity. . Exchange verwendet die AutoErmittlung, um automatisch den richtigen Exchange-Serverendpunkt zu erkennen, der für externe Anforderungen verwendet werden soll.

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

Der Parameter TargetOwaURL gibt die Outlook im Web URL (früher Outlook Web App) der externen Organisation an, die in der Organisationsbeziehung definiert ist. Es wird für Outlook im Web Umleitung in einem standortübergreifenden Exchange-Szenario verwendet. Wenn Sie dieses Attribut konfigurieren, können Benutzer in der Organisation ihre aktuelle Outlook im Web-URL verwenden, um auf Outlook im Web in der externen Organisation zuzugreifen.

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

Der Parameter TargetSharingEpr gibt die URL der Exchange-Zielwebdienste für die externe Organisation an.

Wenn Sie diesen Parameter verwenden, wird diese URL immer verwendet, um den externen Exchange-Server zu erreichen. Die durch den Parameter TargetAutoDiscoverEpr angegebeneURL wird nicht verwendet, um den externen Exchange-Server zu suchen.

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

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.