共用方式為


Set-SPWebApplication

設定指定的 Web 應用程式。

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

Description

此 Cmdlet 包含一個以上的參數集。 您可能只使用一個參數集中的參數,但不可以結合不同參數集的參數。 如需如何使用參數集的詳細資訊,請參閱 Cmdlet 參數集

Cmdlet Set-SPWebApplication 會設定 Identity 參數所指定的 Web 應用程式。 凡是區域特定的設定 (設定 Zone 參數者),都必須提供要設定的區域。 提供的區域必須已經存在。

透過 Cmdlet 更新 IIS 網站 Set-SPWebApplication 的系結時,應該重新指定所有 IIS 系結設定。 這包括 URL、安全通訊端層設定、埠號碼、主機標頭和憑證。 如果未重新指定系結設定,則會還原為其預設值。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet

範例

範例 1

$credentials = Get-Credential
Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -SMTPServerPort 587 -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $credentials

本範例會將 Web 應用程式設定 http://servername 為使用 SMTP 伺服器 mail.example.com、SMTP 伺服器埠 587、來自位址 user@example.com 、回復位址 replyto@example.com ,以及儲存在$credentials物件中的認證。

範例 2

Set-SPWebApplication -Identity http://servername -SMTPServer mail.example.com -OutgoingEmailAddress user@example.com -ReplyToAddress replyto@example.com -SMTPCredentials $null

本範例會將 Web 應用程式設定 http://servername 為使用 SMTP 伺服器 mail.example.com、預設 SMTP 伺服器埠、from 位址 user@example.com 、回復位址 replyto@example.com ,以及以匿名方式連線到 SMTP 伺服器。

參數

-AdditionalClaimProvider

將特定宣告提供者新增至定義的 Web 應用程式。

Type:SPClaimProviderPipeBind[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AllowLegacyEncryption

指定允許使用較舊的 SSL 和 TLS 通訊協定版本和加密套件與此 IIS 網站搭配使用。 舊版加密比新式加密弱,不建議使用。

此功能需要 Windows Server 2022 或更新版本。 使用舊版 Windows Server 部署 SharePoint 時,無法使用此功能。

此參數只有在搭配 SecureSocketsLayer 參數使用時才有效。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

使用 Global 參數時,所有物件會包含在全域儲存區內。 如果不立即使用物件,或使用 Stop-SPAssignment 命令加以捨棄,則可能會有記憶體不足的狀況發生。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AuthenticationMethod

使用 將 Web 應用程式設定為傳統Windows 驗證。 有效值為 NTLM 或 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

定義適用于 Web 應用程式的驗證提供者 () 。

Type:SPAuthenticationProviderPipeBind[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Certificate

指定將用於此 IIS 網站的安全通訊端層 (SSL) 系結,或用於驗證 SMTP 伺服器以傳送電子郵件的憑證。

設定此 IIS 網站的安全通訊端層 (SSL) 系結時,只有在搭配 SecureSocketsLayer 參數使用時,此參數才有效。 設定 SMTP 驗證時,只有在未指定 DisableSMTPEncryption 參數時,此參數才有效。

Type:SPServerCertificatePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

在執行命令之前,提示您確認操作。 如需詳細資訊,請輸入下列命令: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

指定此 Web 應用程式的新預設網站配額範本。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DefaultTimeZone

指定此 Web 應用程式中新網站集合的預設時區。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DisableSMTPEncryption

指定要開啟或關閉 SMTP 加密。

預設值為 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

隱藏 Web 應用程式設定中所涉及的確認訊息。

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-HostHeader

指定此 IIS 網站的主機標頭系結。 主機標頭系結可讓多個 IIS 網站共用相同的埠號碼。 傳送至共用埠號碼的 Web 要求會根據用戶端所傳送的 HTTP 主機標頭值,路由傳送至正確的 IIS 網站。

如果未指定主機標頭系結,則傳送至此埠號碼的所有 Web 要求都會路由傳送至此 IIS 網站,除非另一個 IIS 網站的主機標頭系結符合用戶端所傳送的 HTTP 主機標頭。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

指定 Web 應用程式的名稱或 URL。

此類型必須是有效的名稱 (格式為 WebApplication-1212) 或 URL (格式為 https://example.contoso.com

Type:SPWebApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NotProvisionGlobally

僅使用此 Cmdlet 所指定的變更,在本機伺服器上布建 Web 應用程式。 伺服器陣列中其他伺服器上的 Web 應用程式將不會布建這些變更。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-OutgoingEmailAddress

指定從此 Web 應用程式傳送之電子郵件訊息的新外寄電子郵件地址。 類型必須是有效的位址;例如, 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

指定可存取此 Web 應用程式的埠。 連接埠可以是任何有效的連接埠號碼。

如果您指定已指派的埠號碼,IIS 在變更新網站的埠號碼或舊月臺的埠號碼之前,不會啟動新網站。

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ReplyToEmailAddress

設定回覆的電子郵件地址。

類型必須是有效的位址;例如, 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

啟用此 Web 應用程式的安全通訊端層 (SSL) 加密。 如果您選擇使用 SSL,您必須將伺服器憑證匯入 SharePoint,並將其指派給此 Web 應用程式的 IIS 網站。 完成之前,將無法從此 IIS 網站存取 Web 應用程式。

預設值為 False。

如果省略此參數或設定為 False,此 Web 應用程式會針對指定的埠使用 HTTP。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ServiceApplicationProxyGroup

指定 Web 應用程式要使用的自訂服務應用程式 Proxy 群組。 Web 應用程式會使用此 Proxy 群組中的 Proxy 來連線到服務應用程式。 如果未指定此參數,則會使用伺服器陣列的預設 Proxy 群組。

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

設定登入重新導向 URL 以指向在特定驗證提供者中所定義的 URL。

Type:SPTrustedIdentityTokenIssuerPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SignInRedirectURL

指定 Web 應用程式的登入重新導向 URL。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SMTPCredentials

指定要向 SMTP 伺服器驗證的認證。 將值設定為 $null,以匿名方式連線到 SMTP 伺服器。 如果未指定此參數,則會保留現有的驗證設定。

您必須先使用 Set-SPApplicationCredentialKey PowerShell Cmdlet,在伺服器陣列中的每個伺服器上設定相同的應用程式認證金鑰,再指定認證。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SMTPServer

指定此 Web 應用程式將使用的新輸出 SMTP 伺服器。 設定為 $null以清除伺服器設定。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SMTPServerPort

指定 SMTP 連接埠值。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Url

指定 Web 應用程式區域的負載平衡 URL。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UseServerNameIndication

指定此 IIS 網站的安全通訊端層 (SSL) 系結應使用伺服器名稱指示 (SNI) 。 伺服器名稱指示可讓具有唯一主機標頭和唯一伺服器憑證的多個 IIS 網站共用相同的 SSL 埠。 如果未使用伺服器名稱指示,所有共用相同 SSL 埠的 IIS 網站都必須共用相同的 SSL 憑證。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

顯示訊息會描述命令的功效而不執行命令。 如需詳細資訊,請輸入下列命令: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

設定區域特定的設定時,必須指定要設定的區域。 此區域必須已經存在。

此類型必須是下列任一個值:Default、Intranet、Internet、Extranet 或 Custom。

Type:SPUrlZone
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition