Addalternatedomain: Stsadm-Vorgänge (Windows SharePoint Services)
Vorgangsname: Addalternatedomain
Beschreibung
Fügt eine interne URL hinzu und ordnet sie einer der fünf URL-Zonen einer Webanwendung oder externen Ressource zu.
Dieser Vorgang entspricht der Benutzeroberflächeneinstellung Interne URLs hinzufügen auf der Seite Alternative Zugriffszuordnungen der Website für die SharePoint-Zentraladministration.
Weitere Informationen finden Sie unter Konfigurieren alternativer Zugriffszuordnungen (Windows SharePoint Services).
Syntax
stsadm -o addalternatedomain
-url <URL-Name>
-incomingurl <http://interne.url>
-urlzone {Default | Internet | Intranet | Extranet | Custom}
-resourcename <Name der Ressource außerhalb der Webanwendung>
Parameter
Parametername |
Wert |
Erforderlich? |
Beschreibung |
url |
Eine gültige URL, z. B. https://Servername oder https://Servername:1234 |
Nein. Der resourcename-Parameter darf jedoch nicht gleichzeitig mit dem url-Parameter verwendet werden. |
URL der Webanwendung. Bei diesem Parameter muss es sich um eine vorhandene URL der alternativen Zugriffszuordnungen (AAM) handeln, der einer Webanwendung zugewiesen ist, sodass Stsadm bestimmen kann, auf welche Webanwendung Sie sich beziehen. Bei der URL kann es sich um eine öffentliche URL oder um eine interne URL aus einer Zone handeln, die der jeweiligen Webanwendung zugewiesen ist. |
incomingurl |
Eine gültige URL, z. B. http://sharepoint.courses.contoso.com:1234 |
Ja |
Die interne URL, die hinzugefügt werden soll. Dieser Parameter sollte auf die Teile der URL mit dem Protokollschema, dem Hostnamen und der Portnummer beschränkt werden. Er sollte keine weiteren Teile einer URL enthalten. Sie können einer URL-Zone mehrere interne URLs zuordnen. |
urlzone |
Einer der folgenden Werte:
|
Ja |
Eine der fünf Zonen, der die interne URL zugewiesen ist. |
resourcename |
Ein gültiger Name, z. B. Ressource1 |
Nein. Allerdings muss bereits ein Ressourcenname vorhanden sein, bevor dieser Parameter verwendet werden kann. Sie können mit dem Addzoneurl-Vorgang einen neuen Ressourcennamen erstellen. Hinweis Wenn der resourcename-Parameter verwendet wird, kann der url-Parameter nicht verwendet werden. . |
Gibt die externe Ressource an, zu der die interne URL hinzugefügt werden soll. Dieser Parameter entspricht der Benutzeroberflächeneinstellung Externe Ressourcenzuordnung, die sich auf der Seite Externe Ressourcenzuordnung erstellen der Website für die SharePoint-Zentraladministration befindet. . |
Hinweise
Für jede Webanwendung kann eine separate Zonenzuordnung durchgeführt werden.
In Windows SharePoint Services 2.0 wurde eine interne URL als eingehende URL und eine öffentliche URL als ausgehende URL bezeichnet.
Bei jeder Webanforderung werden von Windows SharePoint Services 3.0 das Protokoll, der Hostheader und der Port der Anforderung bestimmt, und es wird eine übereinstimmende, zuvor eingegebene interne URL gesucht. Wenn eine übereinstimmende interne URL gefunden wird, wird von Windows SharePoint Services 3.0 die Zone bestimmt, die zum Formatieren der Links in der Antwort verwendet wird. Eine URL-Zone enthält eine öffentliche URL und eine oder mehrere interne URLs.
Mit alternativen Zugriffszuordnungen kann eine Webanwendung, die eine Anfrage für eine interne URL in einer der fünf Authentifizierungszonen erhält, Seiten zurückgeben, die Links zur öffentlichen URL für die Zone enthalten. Sie können eine Webanwendung einer Sammlung von Zuordnungen zwischen internen und öffentlichen URLs zuweisen. "Intern" bezieht sich auf die URL einer Webanfrage, wie sie von Windows SharePoint Services 3.0 empfangen wird. "Öffentlich" bezieht sich auf die URL einer extern zugänglichen Website. Die öffentliche URL ist die Basis-URL, die von Windows SharePoint Services 3.0 auf den zurückgegebenen Seiten verwendet wird. Wenn die interne URL von einem Reverseproxygerät geändert wurde, kann sich sich von der öffentlichen URL unterscheiden.
Einer öffentlichen URL können mehrere interne URLs zugeordnet werden. Zuordnungssammlungen können bis zu fünf Authentifizierungszonen enthalten, jede Zone darf jedoch nur über eine einzige öffentliche URL verfügen. Zuordnungssammlungen entsprechen den folgenden Authentifizierungszonen:
Default
Internet
Intranet
Extranet
Custom
Weitere Informationen zu Zonen, URLs und logischer Architektur finden Sie unter Entwerfen der logischen Architektur (Windows SharePoint Services)
Websitesammlungen mit Hostnamen können keine alternativen Zugriffszuordnungen verwenden. Für Websitesammlungen mit Hostnamen wird automatisch angenommen, dass sie sich in der Zone Standard befinden, und die URL der Anforderung darf zwischen Endbenutzer und Server nicht geändert werden.
Beispiele
Wenn ein Reverseproxyserver oder ein Lastenausgleichsmodul eine Anforderung vom Benutzer als https://technet.microsoft.com/de-de/library/cc706993.aspx empfängt und an den Server, auf dem Windows SharePoint Services 3.0 ausgeführt wird, als http://sharepoint.courses.contoso.com:1234 weiterleitet, sollte der Administrator die folgenden URLs für eine SharePoint-Webanwendung konfigurieren:
Interne URL: http://sharepoint.courses.contoso.com:1234
Öffentliche URL: https://technet.microsoft.com/de-de/library/cc706993.aspx
In diesem Beispiel ist https://sharepoint:1234 bereits eine einer Webanwendung zugewiesene AAM-URL, und die Internetzone wird verwendet.
Konfigurieren Sie mithilfe der folgenden Syntax eine interne URL:
stsadm -o addalternatedomain -url https://sharepoint:1234 -urlzone Internet -incomingurl http://sharepoint.courses.contoso.com:1234
Ordnen Sie die öffentliche URL mithilfe der folgenden Syntax der URL-Zone zu:
stsadm -o addzoneurl -url https://sharepoint:1234 -urlzone Internet -zonemappedurl https://technet.microsoft.com/de-de/library/cc706993.aspx
Hinweis
Pro URL-Zone kann es immer nur eine öffentliche URL geben. Hierbei handelt es sich um die URL, die auf Webseiten oder in E-Mail-Nachrichten vom Webserver an den Reverseproxyserver oder an den Client verwendet wird.
Bestätigen Sie die Änderung der internen URL mithilfe der folgenden Syntax:
stsadm -o enumalternatedomains -url http://sharepoint.courses.contoso.com:1234