Freigeben über


Set-PartnerApplication

Dieses Cmdlet ist nur in lokalem Exchange funktionsfähig.

Verwenden Sie das Cmdlet Set-PartnerApplication, um Partneranwendungskonfigurationen in lokalen Exchange-Organisationen zu konfigurieren.

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

Syntax

Set-PartnerApplication
   [-Identity] <PartnerApplicationIdParameter>
   [-ApplicationIdentifier <String>]
   [-Realm <String>]
   [-AcceptSecurityIdentifierInformation <Boolean>]
   [-AccountType <SupportedAccountType>]
   [-ActAsPermissions <String[]>]
   [-AppOnlyPermissions <String[]>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IssuerIdentifier <String>]
   [-LinkedAccount <UserIdParameter>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-PartnerApplication
   [-Identity] <PartnerApplicationIdParameter>
   [-AuthMetadataUrl <String>]
   [-TrustAnySSLCertificate]
   [-AcceptSecurityIdentifierInformation <Boolean>]
   [-AccountType <SupportedAccountType>]
   [-ActAsPermissions <String[]>]
   [-AppOnlyPermissions <String[]>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IssuerIdentifier <String>]
   [-LinkedAccount <UserIdParameter>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-PartnerApplication
   [-Identity] <PartnerApplicationIdParameter>
   [-RefreshAuthMetadata]
   [-AcceptSecurityIdentifierInformation <Boolean>]
   [-AccountType <SupportedAccountType>]
   [-ActAsPermissions <String[]>]
   [-AppOnlyPermissions <String[]>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IssuerIdentifier <String>]
   [-LinkedAccount <UserIdParameter>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Sie können Partneranwendungen wie SharePoint für den Zugriff auf Exchange-Ressourcen konfigurieren. Verwenden Sie das Cmdlet New-PartnerApplication, um eine Partneranwendungskonfiguration für eine Anwendung zu erstellen, die auf Exchange-Ressourcen zugreifen muss. Weitere Informationen finden Sie unter Planen der Exchange 2016-Integration mit SharePoint und Skype for Business. Es wird empfohlen, Partneranwendungen mithilfe des Skripts Configure-EnterprisePartnerApplication.ps1 im Ordner %ExchangeInstallPath%Scripts zu konfigurieren.

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-PartnerApplication HRApp -RefreshAuthMetadata

In diesem Beispiel werden die Autorisierungsmetadaten für die Partneranwendung "HRApp" aktualisiert.

Parameter

-AcceptSecurityIdentifierInformation

Der Parameter AcceptSecurityIdentifierInformation gibt an, ob Exchange Sicherheits-IDs (SIDs) aus einer anderen vertrauenswürdigen Active Directory-Gesamtstruktur für die Partneranwendung akzeptieren soll. Standardmäßig akzeptieren neue Partneranwendungen keine SIDs von einer anderen Gesamtstruktur. Wenn Sie über eine Bereitstellung mit einer vertrauenswürdigen Gesamtstruktur verfügen, legen Sie den Parameter auf $true fest.

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

-AccountType

Der Parameter AccountType gibt den Typ Microsoft Kontos an, der für die Partneranwendung erforderlich ist. Gültige Werte sind:

  • OrganizationalAccount: Dies ist der Standardwert.
  • ConsumerAccount
Type:SupportedAccountType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-ActAsPermissions

Der Parameter ActAsPermissions gibt die Delegatberechtigungen an, die für die Partneranwendung zulässig sind. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Type:String[]
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

-ApplicationIdentifier

Der Parameter ApplicationIdentifier gibt eine eindeutige Anwendungs-ID für die Partneranwendung an, die einen Autorisierungsserver verwendet.

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

-AppOnlyPermissions

Dieser Parameter ist nur in Exchange Server 2013 verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-AuthMetadataUrl

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter AuthMetadataUrl gibt die URL an, aus der Exchange das AuthMetadata-Dokument für eine Partneranwendung abrufen kann, die keinen Autorisierungsserver verwendet.

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

-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 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 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Der Parameter Enabled gibt an, ob die Partneranwendung aktiviert ist. Neue Partneranwendungen sind standardmäßig aktiviert. Legen Sie den Parameter auf $false fest, um die Anwendungskonfiguration im deaktivierten Zustand zu erstellen.

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

-Identity

Der Parameter Identity gibt die Partneranwendung an, die Sie ändern möchten. Sie können einen beliebigen Wert verwenden, der die Partneranwendung eindeutig identifiziert. Beispiel:

  • Name
  • ApplicationID (GUID-Wert)
  • Distinguished Name (DN)
  • GUID
Type:PartnerApplicationIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IssuerIdentifier

Dieser Parameter ist nur in Exchange Server 2013 verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-LinkedAccount

Der LinkedAccount-Parameter gibt ein verknüpftes Active Directory-Benutzerkonto für die Anwendung an. Exchange wertet RBAC-Berechtigungen (Role Based Access Control) für das verknüpfte Konto aus, wenn ein Token autorisiert wird, das zum Ausführen einer Aufgabe verwendet wird.

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

-Name

Der Parameter Name gibt einen neuen Namen für die Partneranwendung an.

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

-Realm

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter Realm gibt einen neuen Sicherheitsbereich für die Partneranwendung an. Wenn das Token aus einer Domäne stammt, die keine akzeptierte Domäne ist, überprüft Exchange den im Token angegebenen Bereich. In einem solchen Szenario können nur Token mit demselben Bereich, der in der Partneranwendung angegeben ist, auf Exchange-Ressourcen zugreifen.

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

-RefreshAuthMetadata

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Schalter RefreshAuthMetadata aktualisiert die Authentifizierungsmetadaten vom Autorisierungsserver. Sie müssen bei dieser Option keinen Wert angeben.

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

-TrustAnySSLCertificate

Dieser Parameter ist im lokalen Exchange verfügbar.

Mit dem Schalter TrustAnySSLCertificate kann Exchange Zertifikate von nicht vertrauenswürdigen Zertifizierungsstellen (Certification Authorities, CAs) akzeptieren. Sie müssen keinen Wert für diese Option angeben.

Es wird nicht empfohlen, diese Option in einer Produktionsumgebung zu verwenden.

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

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