New-SPContentDeploymentPath
新しいコンテンツ展開パスを作成します。
構文
Default (既定)
New-SPContentDeploymentPath
-DestinationCentralAdministrationURL <Uri>
-DestinationSPSite <String>
-DestinationSPWebApplication <Uri>
-Name <String>
-PathAccount <PSCredential>
-SourceSPSite <SPSitePipeBind>
-SourceSPWebApplication <SPWebApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Authentication <PathAuthenticationOption>]
[-CompressionEnabled]
[-Confirm]
[-DeploySecurityInformation <SPIncludeSecurity>]
[-DeployUserNamesEnabled]
[-Description <String>]
[-EventReceiversEnabled]
[-KeepTemporaryFilesOptions <TemporaryFilesOption>]
[-PathEnabled]
[-WhatIf]
[<CommonParameters>]
説明
New-SPContentDeploymentPath コマンドレットでは、コンテンツ展開ジョブの新しいコンテンツ展開パスを追加します。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。
例
例文
C:\PS>$source = Get-SPSite "http://source/"
C:\PS>$credentials=Get-Credential
New-SPContentDeploymentPath -Name "Deployment Path" -SourceSPWebApplication $source.WebApplication -SourceSPSite $source DestinationCentralAdministrationURL "http://destination:8080" -DestinationSPWebApplication "http://destination" -DestinationSPSite "http://destination" -KeepTemporaryFilesOptions "Failure" -PathAccount $credentials -PathEnabled:$true
この例では、 http://source のソースを の宛先に接続する、デプロイ パスという新しいデプロイ パスを作成します http://destination. このパスを有効化し、ジョブの失敗時に一時ファイルを保持するように構成します。
パラメーター
-AssignmentCollection
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
パラメーターのプロパティ
| 型: | SPAssignmentCollection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Authentication
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
認証元フロントエンド Web サーバーで対象の Web アプリケーションと通信するために使用する Windows ベースの認証型を設定します。
この型は、WindowsAuth または BasicAuth のいずれかの値であることが必要です。
パラメーターのプロパティ
| 型: | PathAuthenticationOption |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CompressionEnabled
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
エクスポート中の圧縮を有効にします。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DeploySecurityInformation
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
このコンテンツ展開パスで、エクスポート処理に含めるユーザー情報とグループ情報を指定します。 既定値は All です。
種類は、None、All、または WssOnly のいずれかの値である必要があります - SharePoint Foundation のセキュリティ設定のみを適用します。 ユーザー メンバシップとロールの割り当て (Web デザイナのような既定のロール、または既定のロールから拡張したカスタム ロール) が含まれます。 各プロジェクトのアクセス制御リスト (ACL) は移行されます。 DAP または LDAP サーバーに定義されたユーザー情報は含まれません。
パラメーターのプロパティ
| 型: | SPIncludeSecurity |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DeployUserNamesEnabled
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
展開時にユーザー名を含めるかどうかを指定します。
有効な値は次のいずれかです。
- $True 元の作成者と編集者の情報、時刻と日付のスタンプ、ユーザー参照値を保持します。
- $False 元の日付とタイムスタンプは保持されますが、作成者と編集者のデータはシステム アカウントに置き換えられ、ユーザー参照値は空の文字列 ("") に置き換えられます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Description
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コンテンツ展開パスの説明を設定します。 この説明の長さは、英数字で最大 4,096 文字です。
この型は、有効な文字列であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DestinationCentralAdministrationURL
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
展開先ファームの SharePoint サーバーの全体管理 URL を指定します。
種類は有効な URL (形式) である必要があります http://server_name.
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DestinationSPSite
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
展開先のサイト コレクションを指定します。
この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、http://server_name という形式の有効な URL であるか、有効な SPSite オブジェクト インスタンスであることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DestinationSPWebApplication
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
展開先の Web アプリケーションを指定します。
種類は、有効な URL (形式 http://server_name)、有効な GUID (形式 12345678-90ab-cdef-1234-567890bcdefgh)、Web アプリケーションの有効な名前 (MyOfficeApp1 など)、または有効な SPWebApplication オブジェクトのインスタンスである必要があります。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EventReceiversEnabled
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
インポート中にイベント レシーバーを有効にします。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-KeepTemporaryFilesOptions
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コンテンツの展開が完了した後も一時ファイルを保持するように指定します。
この型は、Never、Always、OnFailure のいずれかの値であることが必要です。
パラメーターのプロパティ
| 型: | TemporaryFilesOption |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
新しいコンテンツ展開パスの名前を指定します。
この型は、コンテンツ展開パスの有効な名前 (DeployPath1 など) であることが必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PathAccount
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
展開先ファームの全体管理のページにおける管理者であるユーザーの ID を指定します。
この型は、有効な SharePoint ユーザーであることが必要です。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PathEnabled
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
新しいコンテンツ展開パスを有効にします。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SourceSPSite
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
展開パスの展開元サイト コレクションを指定します。 SourceSPWebApplication パラメーターで指定されている展開元のサイト コレクションであることが必要です。
この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、http://server_name という形式の有効な URL であるか、有効な SPSite オブジェクト インスタンスであることが必要です。
パラメーターのプロパティ
| 型: | SPSitePipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SourceSPWebApplication
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
展開パスの展開元 Web アプリケーションを指定します。
種類は、有効な URL (形式 http://server_name)、有効な GUID (形式 12345678-90ab-cdef-1234-567890bcdefgh)、SharePoint Web アプリケーションの有効な名前 (MyOfficeApp1 など)、または有効な SPWebApplication オブジェクトのインスタンスである必要があります。
パラメーターのプロパティ
| 型: | SPWebApplicationPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。