New-SPContentDeploymentPath

新しいコンテンツ展開パスを作成します。

構文

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 を宛先に接続する Deployment Path という名前の新しいデプロイ パスを作成します。 http://destination. このパスを有効化し、ジョブの失敗時に一時ファイルを保持するように構成します。

パラメーター

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Authentication

認証元フロントエンド Web サーバーで対象の Web アプリケーションと通信するために使用する Windows ベースの認証型を設定します。

この型は、WindowsAuth または BasicAuth のいずれかの値であることが必要です。

Type:PathAuthenticationOption
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CompressionEnabled

エクスポート中の圧縮を有効にします。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DeploySecurityInformation

このコンテンツ展開パスで、エクスポート処理に含めるユーザー情報とグループ情報を指定します。 既定値は All です。

型は、None、All、または WssOnly のいずれかの値である必要があります。SharePoint Foundation のセキュリティ設定のみを適用します。 ユーザー メンバシップとロールの割り当て (Web デザイナのような既定のロール、または既定のロールから拡張したカスタム ロール) が含まれます。 各プロジェクトのアクセス制御リスト (ACL) は移行されます。 DAP または LDAP サーバーに定義されたユーザー情報は含まれません。

Type:SPIncludeSecurity
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DeployUserNamesEnabled

展開時にユーザー名を含めるかどうかを指定します。

有効な値は次のいずれかです。

  • $True 元の作成者とエディターの情報、時刻と日付のスタンプ、およびユーザー参照値を保持します。
  • $False 元の日付と時刻のスタンプを保持しますが、作成者とエディターのデータをシステム アカウントに置き換え、ユーザー参照値を空の文字列 ("") に置き換えます。
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Description

コンテンツ展開パスの説明を設定します。 この説明の長さは、英数字で最大 4,096 文字です。

この型は、有効な文字列であることが必要です。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DestinationCentralAdministrationURL

展開先ファームの SharePoint サーバーの全体管理 URL を指定します。

型は、フォーム内の有効な URL である必要があります http://server_name.

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DestinationSPSite

展開先のサイト コレクションを指定します。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、http://server_name という形式の有効な URL であるか、有効な SPSite オブジェクト インスタンスであることが必要です。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DestinationSPWebApplication

展開先の Web アプリケーションを指定します。

型は、フォーム http://server_name12345678-90ab-cdef-1234-567890bcdefgh、Web アプリケーションの有効な名前 (MyOfficeApp1 など)、または有効な SPWebApplication オブジェクトのインスタンスの有効な URL である必要があります。

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-EventReceiversEnabled

インポート中にイベント レシーバーを有効にします。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-KeepTemporaryFilesOptions

コンテンツの展開が完了した後も一時ファイルを保持するように指定します。

この型は、Never、Always、OnFailure のいずれかの値であることが必要です。

Type:TemporaryFilesOption
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

新しいコンテンツ展開パスの名前を指定します。

この型は、コンテンツ展開パスの有効な名前 (DeployPath1 など) であることが必要です。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-PathAccount

展開先ファームの全体管理のページにおける管理者であるユーザーの ID を指定します。

この型は、有効な SharePoint ユーザーであることが必要です。

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-PathEnabled

新しいコンテンツ展開パスを有効にします。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourceSPSite

展開パスの展開元サイト コレクションを指定します。 SourceSPWebApplication パラメーターで指定されている展開元のサイト コレクションであることが必要です。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、http://server_name という形式の有効な URL であるか、有効な SPSite オブジェクト インスタンスであることが必要です。

Type:SPSitePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SourceSPWebApplication

展開パスの展開元 Web アプリケーションを指定します。

型は、フォーム http://server_name12345678-90ab-cdef-1234-567890bcdefgh、SharePoint Web アプリケーションの有効な名前 (MyOfficeApp1 など) の有効な URL、または有効な SPWebApplication オブジェクトのインスタンスである必要があります。

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019