Set-SPWebApplication
Konfiguriert die angegebene Webanwendung.
Syntax
Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
[-DefaultTimeZone <Int32>]
[-DefaultQuotaTemplate <String>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-AuthenticationMethod <String>]
[-Force]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-Zone <SPUrlZone>
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
-Port <Int32>
[-Url <String>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-SPWebApplication
[-Identity] <SPWebApplicationPipeBind>
-SMTPServer <String>
[-SMTPServerPort <Int32>]
[-OutgoingEmailAddress <String>]
[-ReplyToEmailAddress <String>]
[-SMTPCredentials <PSCredential>]
[-DisableSMTPEncryption]
[-Certificate <SPServerCertificatePipeBind>]
[-NotProvisionGlobally]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.
Das Set-SPWebApplication Cmdlet konfiguriert die durch den Identity-Parameter angegebene Webanwendung.
Für zonenspezifische Einstellungen (für den festgelegten Zone-Parameter) muss die zu konfigurierende Zone angegeben werden.
Die angegebene Zone muss bereits vorhanden sein.
Alle IIS-Bindungseinstellungen sollten beim Aktualisieren der Bindung einer IIS-Website über das Set-SPWebApplication Cmdlet erneut angegeben werden. Dies umfasst die URL, die Einstellung der Secure Sockets-Ebene, die Portnummer, den Hostheader und das Zertifikat. Wenn eine Bindungseinstellung nicht neu angegeben wird, wird sie auf ihren Standardwert zurückgesetzt.
Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.
Beispiele
BEISPIEL 1
$credentials = Get-Credential
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -SMTPServerPort 587 -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $credentialsIn diesem Beispiel wird festgelegt, dass die http://servername Webanwendung den SMTP-Server mail.example.com, den SMTP-Serverport 587, die von-Adresse user@example.com, die Antwortadresse replyto@example.comund die im $credentials-Objekt gespeicherten Anmeldeinformationen verwendet.
BEISPIEL 2
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $nullIn diesem Beispiel wird festgelegt, dass die http://servername Webanwendung den SMTP-Server mail.example.com, den Standardport des SMTP-Servers, die Vonadresse user@example.com, die Antwortadresse replyto@example.comund die anonyme Verbindung mit dem SMTP-Server verwendet.
Parameter
-AdditionalClaimProvider
Fügt der definierten Webanwendung einen bestimmten Anspruchsanbieter hinzu.
| Type: | SPClaimProviderPipeBind[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AllowLegacyEncryption
Gibt an, dass ältere SSL- und TLS-Protokollversionen und Verschlüsselungssammlungen mit dieser IIS-Website verwendet werden dürfen. Legacyverschlüsselung ist schwächer als die moderne Verschlüsselung und wird nicht empfohlen.
Dieses Feature erfordert Windows Server 2022 oder höher. Dieses Feature ist nicht verfügbar, wenn SharePoint mit früheren Versionen von Windows Server bereitgestellt wird.
Dieser Parameter ist nur gültig, wenn er mit dem Parameter SecureSocketsLayer verwendet wird.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.
Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten.
Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationMethod
Verwenden Sie , um eine Webanwendung auf klassische Windows-Authentifizierung festzulegen. Gültige Werte sind "NTLM" oder "Kerberos".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AuthenticationProvider
Definiert die Authentifizierungsanbieter, die für die Webanwendung gelten.
| Type: | SPAuthenticationProviderPipeBind[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Certificate
Gibt das Zertifikat an, das für die SSL-Bindung (Secure Sockets Layer) dieser IIS-Website oder für die Authentifizierung bei einem SMTP-Server zum Senden von E-Mails verwendet wird.
Beim Konfigurieren der SSL-Bindung (Secure Sockets Layer) dieser IIS-Website ist dieser Parameter nur gültig, wenn er mit dem SecureSocketsLayer-Parameter verwendet wird. Beim Konfigurieren der SMTP-Authentifizierung ist dieser Parameter nur gültig, wenn der Parameter DisableSMTPEncryption nicht angegeben ist.
| Type: | SPServerCertificatePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DefaultQuotaTemplate
Gibt die neue Standardvorlage für das Websitekontingent für diese Webanwendung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DefaultTimeZone
Gibt die Standardzeitzone für neue Websitesammlungen in dieser Webanwendung an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DisableSMTPEncryption
Gibt an, ob die SMTP-Verschlüsselung aktiviert oder deaktiviert werden soll.
Der Standardwert ist false.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Force
Unterdrückt Bestätigungsmeldungen, die an den Einstellungen für eine Webanwendung beteiligt sind.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-HostHeader
Gibt die Hostheaderbindung für diese IIS-Website an. Eine Hostheaderbindung ermöglicht es mehreren IIS-Websites, dieselbe Portnummer gemeinsam zu verwenden. Webanforderungen, die an eine freigegebene Portnummer gesendet werden, werden basierend auf dem Wert des vom Client gesendeten HTTP-Hostheaders an die richtige IIS-Website weitergeleitet.
Wenn keine Hostheaderbindung angegeben ist, werden alle Webanforderungen, die an diese Portnummer gesendet werden, an diese IIS-Website weitergeleitet, es sei denn, eine andere IIS-Website verfügt über eine Hostheaderbindung, die mit dem vom Client gesendeten HTTP-Hostheader übereinstimmt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Identity
Gibt den Namen oder die URL der Webanwendung an.
Bei dem Typ muss es sich um einen gültigen Namen im Format WebApplication-1212 oder eine URL im Format https://example.contoso.com handeln.
| Type: | SPWebApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NotProvisionGlobally
Stellt nur die Webanwendung auf dem lokalen Server mit den von diesem Cmdlet angegebenen Änderungen bereit. Webanwendungen auf anderen Servern in der Farm werden nicht mit diesen Änderungen bereitgestellt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-OutgoingEmailAddress
Gibt die neue ausgehende E-Mail-Adresse für E-Mail-Nachrichten an, die von dieser Webanwendung gesendet werden. Der Typ muss eine gültige Adresse sein. Beispiel: someone@example.com.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Port
Gibt den Port an, über den auf diese Webanwendung zugegriffen werden kann. Dabei kann es sich um eine beliebige gültige Portnummer handeln.
Wenn Sie eine Portnummer angeben, die bereits zugewiesen wurde, startet IIS die neue Website erst, wenn Sie die Portnummer der neuen Website oder die Portnummer der alten Website ändern.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ReplyToEmailAddress
Konfiguriert die Antwort-E-Mail-Adresse.
Der Typ muss eine gültige Adresse sein. Beispiel: someone@example.com.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SecureSocketsLayer
Aktiviert die SSL-Verschlüsselung (Secure Sockets Layer) für diese Webanwendung. Wenn Sie ssl verwenden möchten, müssen Sie ein Serverzertifikat in SharePoint importieren und es der IIS-Website für diese Webanwendung zuweisen. Solange dies nicht geschehen ist, kann von dieser IIS-Website nicht auf die Webanwendung zugegriffen werden.
Der Standardwert ist False.
Wenn dieser Parameter ausgelassen oder auf False festgelegt wird, verwendet diese Webanwendung HTTP für den angegebenen Port.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ServiceApplicationProxyGroup
Gibt eine benutzerdefinierte Dienstanwendungsproxygruppe an, die von der Webanwendung verwendet werden soll. Die Webanwendung verwendet die Proxys in dieser Proxygruppe, um eine Verbindung mit Dienstanwendungen herzustellen. Wenn dieser Parameter nicht angegeben ist, wird die Standardproxygruppe der Farm verwendet.
| Type: | SPServiceApplicationProxyGroupPipeBind |
| Aliases: | ProxyGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SignInRedirectProvider
Legt die Umleitungs-URL für die Anmeldung so fest, dass sie auf die URL verweist, die im angegebenen Authentifizierungsanbieter definiert ist.
| Type: | SPTrustedIdentityTokenIssuerPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SignInRedirectURL
Gibt die Anmeldeumleitungs-URL für die Webanwendung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPCredentials
Gibt Anmeldeinformationen für die Authentifizierung beim SMTP-Server an. Legen Sie den Wert auf $null fest, um anonym eine Verbindung mit dem SMTP-Server herzustellen. Wenn dieser Parameter nicht angegeben wird, werden die vorhandenen Authentifizierungseinstellungen beibehalten.
Sie müssen das Set-SPApplicationCredentialKey PowerShell-Cmdlet verwenden, um einen identischen Anwendungsanmeldeinformationsschlüssel auf jedem Server in der Farm festzulegen, bevor Sie Anmeldeinformationen angeben.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServer
Gibt den neuen ausgehenden SMTP-Server an, den diese Webanwendung verwenden wird. Legen Sie auf $null fest, um die Servereinstellung zu löschen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SMTPServerPort
Gibt einen Wert für den SMTP-Port an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Url
Gibt die URL mit Lastenausgleich für die Webanwendungszone an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UseServerNameIndication
Gibt an, dass für die SSL-Bindung (Secure Sockets Layer) dieser IIS-Website SNI (Server Name Indication) verwendet werden soll. Die Servernamensanzeige ermöglicht es mehreren IIS-Websites mit eindeutigen Hostheadern und eindeutigen Serverzertifikaten, denselben SSL-Port gemeinsam zu nutzen. Wenn die Servernamensanzeige nicht verwendet wird, müssen alle IIS-Websites, die denselben SSL-Port verwenden, dasselbe SSL-Zertifikat verwenden.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen.
Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Zone
Beim Konfigurieren zonenspezifischer Einstellungen muss die zu konfigurierende Zone angegeben werden. Die Zone muss bereits vorhanden sein.
Bei dem Typ muss es sich um einen der folgenden Werte handeln: Standard, Intranet, Internet, Extranet oder Benutzerdefiniert.
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |