次の方法で共有


Set-SPWebApplication

指定した Web アプリケーションを構成します。

構文

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

説明

このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用法に関する詳しい情報については、「コマンドレットのパラメーター セット」を参照してください。

Set-SPWebApplication コマンドレットは、Identity パラメーターで指定された Web アプリケーションを構成します。 ゾーン固有の設定を構成するには、構成するゾーンを Zone パラメーターで指定します。 既存のゾーンを指定する必要があります。

コマンドレットを使用して IIS Web サイトのバインドを更新する場合は、すべての IIS バインド設定を再指定する必要があります。 これには、URL、セキュリティで保護されたソケット レイヤーの設定、ポート番号、ホスト ヘッダー、および証明書が含まれます。 バインド設定が再指定されていない場合は、既定値に戻されます。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

例 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

次の使用例は、SMTP サーバー mail.example.com を使用する http://servername Web アプリケーション、SMTP サーバー ポート 587、from address user@example.com、reply-to address replyto@example.com、および $credentials オブジェクトに格納されている資格情報を設定します。

例 2

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

次の使用例は、SMTP サーバー mail.example.com、既定の SMTP サーバー ポート、from アドレス user@example.com、応答先アドレス replyto@example.comを使用し、SMTP サーバーに匿名で接続するように、http://servername Web アプリケーションを設定します。

パラメーター

-AdditionalClaimProvider

定義された Web アプリケーションに特定の要求プロバイダーを追加します。

型:SPClaimProviderPipeBind[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-AllowLegacyEncryption

この IIS Web サイトで古い SSL および TLS プロトコルのバージョンと暗号スイートを使用することを許可するように指定します。 従来の暗号化は最新の暗号化よりも弱く、推奨されません。

この機能には、Windows Server 2022 以上が必要です。 この機能は、SharePoint が以前のバージョンのWindows Serverで展開されている場合は使用できません。

このパラメーターは、SecureSocketsLayer パラメーターと共に使用する場合にのみ有効です。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

型:SPAssignmentCollection
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-AuthenticationMethod

を使用して、Web アプリケーションをクラシック Windows 認証に設定します。 有効な値は NTLM または Kerberos です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-AuthenticationProvider

Web アプリケーションに適用される認証プロバイダーを定義します。

型:SPAuthenticationProviderPipeBind[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-Certificate

この IIS Web サイトの Secure Sockets Layer (SSL) バインド、または電子メールを送信する SMTP サーバーへの認証に使用する証明書を指定します。

この IIS Web サイトの Secure Sockets Layer (SSL) バインドを構成する場合、このパラメーターは SecureSocketsLayer パラメーターと共に使用する場合にのみ有効です。 SMTP 認証を構成する場合、このパラメーターは DisableSMTPEncryption パラメーターが指定されていない場合にのみ有効です。

型:SPServerCertificatePipeBind
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-Confirm

コマンドを実行する前に確認メッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-DefaultQuotaTemplate

この Web アプリケーションの新しい既定のサイト クォータ テンプレートを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-DefaultTimeZone

この Web アプリケーションの新しいサイト コレクションの既定のタイム ゾーンを指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-DisableSMTPEncryption

SMTP 暗号化を有効にするか無効にするかどうかを指定します。

既定値は false です。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-Force

Web アプリケーションの設定に関連する確認メッセージを抑制します。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-HostHeader

この IIS Web サイトのホスト ヘッダー バインドを指定します。 ホスト ヘッダー バインドを使用すると、複数の IIS Web サイトで同じポート番号を共有できます。 共有ポート番号に送信された Web 要求は、クライアントによって送信された HTTP ホスト ヘッダーの値に基づいて、正しい IIS Web サイトにルーティングされます。

ホスト ヘッダー バインドが指定されていない場合、このポート番号に送信されるすべての Web 要求は、別の IIS Web サイトにクライアントから送信された HTTP ホスト ヘッダーと一致するホスト ヘッダー バインドがない限り、この IIS Web サイトにルーティングされます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-Identity

Web アプリケーションの名前または URL を指定します。

この型は、WebApplication-1212 という形式の有効な名前であるか、http://<サーバー名>/WebApplicaiton-1212 という形式の URL であることが必要です。

型:SPWebApplicationPipeBind
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-NotProvisionGlobally

このコマンドレットによって指定された変更を使用して、ローカル サーバー上の Web アプリケーションのみをプロビジョニングします。 ファーム内の他のサーバー上の Web アプリケーションは、これらの変更と共にプロビジョニングされません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-OutgoingEmailAddress

この Web アプリケーションから送信される電子メール メッセージの新しい送信電子メール アドレスを指定します。 型は有効なアドレスである必要があります。たとえば、 someone@example.com。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-Port

この Web アプリケーションにアクセスできるポートを指定します。 任意の有効なポート番号を指定できます。

割り当て済みのポート番号を指定すると、新しいサイトまたは古いサイトのどちらかのポート番号を変更するまで、IIS は新しいサイトを開始しません。

型:Int32
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-ReplyToEmailAddress

返信用の電子メール アドレスを設定します。

型は有効なアドレスである必要があります。たとえば、 someone@example.com。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-SecureSocketsLayer

この Web アプリケーションの Secure Sockets Layer (SSL) 暗号化を有効にします。 SSL を使用する場合は、サーバー証明書を SharePoint にインポートし、この Web アプリケーションの IIS Web サイトに割り当てる必要があります。 この操作が完了するまで、この IIS Web サイトから Web アプリケーションにアクセスできなくなります。

既定値は False です。

このパラメーターを省略するか False に設定すると、この Web アプリケーションは指定されたポートに HTTP を使用します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-ServiceApplicationProxyGroup

Web アプリケーションで使用するカスタム サービス アプリケーション プロキシ グループを指定します。 Web アプリケーションは、このプロキシ グループ内のプロキシを使用してサービス アプリケーションに接続します。 このパラメーターを指定しない場合は、ファームの既定のプロキシ グループが使用されます。

型:SPServiceApplicationProxyGroupPipeBind
Aliases:ProxyGroup
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-SignInRedirectProvider

指定された認証プロバイダーで定義されている URL を指すようにサインイン リダイレクト URL を設定します。

型:SPTrustedIdentityTokenIssuerPipeBind
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-SignInRedirectURL

Web アプリケーションのサインイン リダイレクト URL を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-SMTPCredentials

SMTP サーバーに対して認証する資格情報を指定します。 SMTP サーバーに匿名で接続するには、値を $null に設定します。 このパラメーターが指定されていない場合、既存の認証設定は保持されます。

Set-SPApplicationCredentialKey PowerShell コマンドレットを使用して、資格情報を指定する前に、ファーム内の各サーバーで同じアプリケーション資格情報キーを設定する必要があります。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-SMTPServer

この Web アプリケーションで使用する新しい送信 SMTP サーバーを指定します。 [$null] に設定すると、サーバー設定がクリアされます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-SMTPServerPort

SMTP ポート値を指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Url

Web アプリケーション ゾーンの負荷分散 URL を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-UseServerNameIndication

この IIS Web サイトの Secure Sockets Layer (SSL) バインドでサーバー名表示 (SNI) を使用することを指定します。 サーバー名表示を使用すると、一意のホスト ヘッダーと一意のサーバー証明書を持つ複数の IIS Web サイトが同じ SSL ポートを共有できます。 サーバー名表示を使用しない場合、同じ SSL ポートを共有するすべての IIS Web サイトで同じ SSL 証明書を共有する必要があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-WhatIf

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition

-Zone

ゾーン固有の設定を構成するには、構成するゾーンを指定します。 既存のゾーンを指定する必要があります。

この型は、 Default 、 Intranet 、 Internet 、 Extranet 、または Custom のいずれかの値であることが必要です。

型:SPUrlZone
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False
適用対象:SharePoint Server Subscription Edition