New-SPWebApplication
ローカル ファーム内に新しい Web アプリケーションを作成します。
構文
New-SPWebApplication
-Name <String>
-ApplicationPool <String>
[-ApplicationPoolAccount <SPProcessAccountPipeBind>]
[-ServiceApplicationProxyGroup <SPServiceApplicationProxyGroupPipeBind>]
[-SecureSocketsLayer]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
[-Port <UInt32>]
[-AllowAnonymousAccess]
[-Path <String>]
[-Url <String>]
[-AuthenticationMethod <String>]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-UserSettingsProvider <SPUserSettingsProviderPipeBind>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseServer <String>]
[-DatabaseName <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Name パラメーターで指定した新しい Web アプリケーションを作成します。 DatabaseCredentials パラメーターで指定するユーザーは、データベース サーバー上の dbcreator 固定サーバー ロールのメンバーであることが必要です。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
------------------ 例 1 -----------------------
New-SPWebApplication -Name "Contoso Internet Site" -Port 80 -HostHeader sharepoint.contoso.com -URL "http://www.contoso.com" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")この例では、sharepoint.contoso.com の内部ホスト ヘッダーと のパブリック URL を http://www.contoso.com使用して、新しい Web アプリケーションを作成します。
------------------ 例 2 -----------------------
New-SPWebApplication -Name "Contoso Internet Site" -Port 443 -SecureSocketsLayer -HostHeader sharepoint.contoso.com -URL "https://www.contoso.com:443" -ApplicationPool "ContosoAppPool" -ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")この例では、sharepoint.contoso.com の内部ホスト ヘッダーと のパブリック URL を使用して、新しい SSL 対応 Web アプリケーションを https://www.contoso.com作成します。
------------------ 例 3 -----------------------
$ap = New-SPAuthenticationProvider
New-SPWebApplication -Name "Contoso Internet Site" -URL "https://www.contoso.com" -Port 443
-ApplicationPool "ContosoAppPool"
-ApplicationPoolAccount (Get-SPManagedAccount "DOMAIN\wa")
-AuthenticationProvider $ap -SecureSocketsLayerドメイン アカウント ドメイン\wa を使用して、URL https://www.contoso.com に Windows クレーム Web アプリケーションを作成します。
パラメーター
-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 |
-AllowAnonymousAccess
Web アプリケーションへの匿名アクセスを許可します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AllowLegacyEncryption
この IIS Web サイトで古い SSL および TLS プロトコルのバージョンと暗号スイートを使用することを許可するように指定します。 従来の暗号化は最新の暗号化よりも弱く、推奨されません。
この機能には、Windows Server 2022 以降が必要です。 この機能は、SharePoint が以前のバージョンの Windows Server と共に展開されている場合は使用できません。
このパラメーターは、SecureSocketsLayer パラメーターと共に使用する場合にのみ有効です。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ApplicationPool
使用するアプリケーション プールの名前 (SharePoint - 1213 など) を指定します。 指定した名前のアプリケーション プールが存在しない場合、 ApplicationPoolAccount パラメーターを指定する必要があります (この場合、新しいアプリケーション プールが作成されます)。 値を指定しない場合、既定のアプリケーション プールが使用されます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ApplicationPoolAccount
このアプリケーション プールを実行するユーザー アカウントを指定します。
コマンドレットを Get-SPIisWebServicApplicationPool 使用してシステム アカウントを使用します。
| Type: | SPProcessAccountPipeBind |
| 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 オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
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
Kerberos または NTLM の認証方法を指定します。 値を指定しない場合、既定値の NTLM が適用されます。
| 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 アプリケーションに適用される 1 つまたは複数の認証プロバイダーを指定します。
| 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 Web サイトの Secure Sockets Layer (SSL) バインドに使用する証明書を指定します。 このパラメーターは、SecureSocketsLayer パラメーターと共に使用する場合にのみ有効です。
| 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 |
-DatabaseCredentials
データベース ユーザー アカウントの Windows PowerShell Credential オブジェクトを指定します。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DatabaseName
新しい Web アプリケーションの初期コンテンツ データベースの名前を指定します。
この型は、有効なデータベース名 (ContentDB1 など) であることが必要です。 値が指定されていない場合、WSS_Content_<GUID> 形式の値が自動生成されます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-DatabaseServer
Specifies the database server name. The type must be a valid database server name, in the form SQL1; where named instances are used, the format can appear as server\server. The default SQL server instance is used if a value is not provided.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-HostHeader
この IIS Web サイトのホスト ヘッダー バインドを指定します。 ホスト ヘッダー バインドを使用すると、複数の IIS Web サイトで同じポート番号を共有できます。 共有ポート番号に送信された Web 要求は、クライアントによって送信された HTTP ホスト ヘッダーの値に基づいて、正しい IIS Web サイトにルーティングされます。
ホスト ヘッダー バインドが指定されていない場合、このポート番号に送信されるすべての Web 要求は、別の IIS Web サイトに、クライアントから送信された HTTP ホスト ヘッダーと一致するホスト ヘッダー バインドがない限り、この IIS Web サイトにルーティングされます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
新しい Web アプリケーションの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Path
仮想ディレクトリ フォルダー内の新しい Web アプリケーションの物理ディレクトリを指定します。 この型は、C:\Inetpub\wwwroot\MyWebApplication という形式の有効なパスであることが必要です。 値が指定されていない場合、値 %wwwroot%\wss\VirtualDirectories\<portnumber> が適用されます。
| 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: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SecureSocketsLayer
この Web アプリケーションに対して SSL (Secure Sockets Layer) 暗号化を有効にします。 SSL を使用する場合は、サーバー証明書を SharePoint にインポートし、この Web アプリケーションの IIS Web サイトに割り当てる必要があります。 この操作が完了するまで、この IIS Web サイトから 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 アプリケーションのカスタム サービス アプリケーション プロキシ グループを指定します。 Web アプリケーションでは、このプロキシ グループのプロキシを使用して、サービス アプリケーションに接続します。 このパラメーターを指定しない場合、ファームの既定のプロキシ グループが使用されます。
| 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 |
-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 |
-UserSettingsProvider
外部のユーザー設定プロバイダーへのアクセスを提供します。
| Type: | SPUserSettingsProviderPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UseServerNameIndication
この IIS Web サイトの Secure Sockets Layer (SSL) バインドでサーバー名表示 (SNI) を使用することを指定します。 サーバー名表示を使用すると、一意のホスト ヘッダーと一意のサーバー証明書を持つ複数の IIS Web サイトが同じ SSL ポートを共有できます。 サーバー名表示を使用しない場合、同じ SSL ポートを共有するすべての IIS Web サイトで同じサーバー証明書を共有する必要があります。
| 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 |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示