New-SPWebApplicationExtension
Web アプリケーションの新しいゾーン インスタンスを作成します。
構文
New-SPWebApplicationExtension
[-Identity] <SPWebApplicationPipeBind>
-Name <String>
-Zone <SPUrlZone>
[-Port <UInt32>]
[-HostHeader <String>]
[-Certificate <SPServerCertificatePipeBind>]
[-UseServerNameIndication]
[-AllowLegacyEncryption]
[-Path <String>]
[-Url <String>]
[-AuthenticationMethod <String>]
[-AllowAnonymousAccess]
[-SecureSocketsLayer]
[-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
[-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
[-SignInRedirectURL <String>]
[-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
コマンドレットは New-SPWebApplicationExtension 、Web アプリケーションの新しいゾーン インスタンスを作成します。
これにより、Web アプリケーションが拡張され、既存の Web アプリケーションにある同じコンテンツに対して代替権限を設定できます。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
------------------ 例 -----------------------
Get-SPWebApplication http://sitename | New-SPWebApplicationExtension -Name "ExtranetSite" -SecureSocketsLayer -Zone "Extranet" -URL "https://extranet.sitename.com"この例では、 で http://sitename 指定された Web アプリケーションを SSL 用のエクストラネット ゾーンに拡張します。
パラメーター
-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 |
-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 の認証方法を指定します。
| 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 Web サイトの Secure Sockets Layer (SSL) バインドに使用する証明書を指定します。 このパラメーターは、SecureSocketsLayer パラメーターと共に使用する場合にのみ有効です。
| Type: | SPServerCertificatePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-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 |
-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 |
-Identity
拡張する Web アプリケーションを指定します。
| Type: | SPWebApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
Web アプリケーションの新しい IIS Web サイトの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Path
新しい Web サイトの物理ディレクトリ (仮想ディレクトリ フォルダー内) を指定します。 この型は、C:\Inetpub\wwwroot\MyWebApplication という形式の有効なパスであることが必要です。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Port
アプリケーション ポートを指定します。 任意の有効なポート番号を指定できます。
ポートを指定しなかった場合は、競合しないポート番号が自動的に生成されます。
割り当て済みのポート番号を指定すると、新しいサイトまたは古いサイトのいずれかのポート番号を変更するまで、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 |
-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 |
-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 |
-Zone
この新しい拡張の内部 URL を関連付ける 5 つのゾーンの 1 つを指定します。 このゾーンは既に使用できません。
型は、既定値、イントラネット、インターネット、エクストラネット、またはカスタムのいずれかの値である必要があります。
| Type: | SPUrlZone |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |