New-SPContentDeploymentJob

モジュール:
SharePointServer module

コンテンツ展開ジョブを作成します。

構文

Default (既定) 

New-SPContentDeploymentJob
    -Name <String>
    -SPContentDeploymentPath <SPContentDeploymentPathPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Description <String>]
    [-EmailAddresses <String[]>]
    [-EmailNotifications <ContentDeploymentNotificationSettings>]
    [-HostingSupportEnabled]
    [-IncrementalEnabled]
    [-Schedule <String>]
    [-ScheduleEnabled]
    [-Scope <SPWebPipeBind[]>]
    [-SqlSnapshotSetting <ContentDeploymentSqlSnapshotSetting>]
    [-WhatIf]
    [<CommonParameters>]

説明

New-SPContentDeploymentJob コマンドレットでは、ファームに新しいコンテンツ展開ジョブを追加します。

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

例

例文

Get-SPContentDeploymentPath "Path 1" | New-SPContentDeploymentJob -Name "Deployment Job" -SPContentDeploymentPath $_ -IncrementalEnabled:$true -ScheduleEnabled:$false

この例では、展開パス Path 1 を使用して新しいコンテンツ展開ジョブ Deployment Job を作成します。 このジョブを増分ジョブとして構成し、スケジュールは設定しません。

パラメーター

-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

-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

-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

-EmailAddresses

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

この ContentDeploymentJob オブジェクトに関する通知電子メールを受け取るユーザーの電子メール アドレスを指定します。

この型は、有効な電子メール アドレスのリストであることが必要です。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EmailNotifications

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

この ContentDeploymentJob オブジェクトに関する電子メール通知の送信方法を指定します。

この型は、次のいずれかであることが必要です。

- Never。ジョブが正常に完了したときにも、失敗したときにも、電子メール通知を送信しません。

  • SendEmailOnSuccess は、コンテンツ展開ジョブが成功した場合に電子メール通知が送信されることを指定します。
  • SendEmailOnFailure は、コンテンツ展開ジョブが失敗した場合に電子メール通知が送信されることを指定します。
  • SendEmailOnAlways ジョブが成功または失敗したときに電子メール通知が送信されることを指定します。

パラメーターのプロパティ

型:ContentDeploymentNotificationSettings
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-HostingSupportEnabled

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

特別なホスティング動作を有効にします。 既定値は False です。

通常、コンテンツ展開ジョブは SharePoint サーバーの全体管理 Web サイトを使用して有効または無効にします。 ただし、ホスティングの場合、テナント管理者にはサーバーの全体管理ページにアクセスしてジョブを構成するためのアクセス許可がありません。 したがって、HostingSupportEnabled パラメーターが True に設定されている場合、ホストはジョブを作成し、テナントはテナント管理サイトから展開ジョブを有効または無効にできます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IncrementalEnabled

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

変更の増分のみを対象のサイト コレクションに展開するように指定します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

新しいコンテンツ展開ジョブの名前を指定します。

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Schedule

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

展開ジョブのスケジュールを設定します。

この型は、有効な SPSchedule オブジェクトであることが必要です。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ScheduleEnabled

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

展開ジョブのスケジュールを有効にします。 スケジュールが無効の場合、ジョブは手動で実行する必要があります。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Scope

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

展開ジョブの範囲を設定します。 渡される SPSite は展開元サイト コレクションの現在のパスに存在していることが必要です。 既定の範囲は、サイト コレクション全体です。 有効な値は、SPWeb オブジェクトおよび SPWeb オブジェクトの配列です。

型は、12345678-90ab-cdef-1234-567890bcdefgh の形式の有効な GUID である必要があります。SharePoint Foundation Web サイトの有効な名前 (MySPSite1 など)または有効な SPWeb オブジェクトのインスタンス。

パラメーターのプロパティ

型:

SPWebPipeBind[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SPContentDeploymentPath

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

新しい展開ジョブに関連付ける展開パスを指定します。

この型は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、コンテンツ展開ジョブの有効な名前 (DeployJob1 など) であるか、有効な SPContentDeploymentJob オブジェクト インスタンスであることが必要です。

パラメーターのプロパティ

型:SPContentDeploymentPathPipeBind
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SqlSnapshotSetting

適用対象: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019

エクスポート プロセスに使用するソース SharePoint Foundation コンテンツ データベースのデータベース スナップショットを作成します。

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

  • なし
  • CreateNew

CreateNew 値には、SQL Server Enterprise Edition がインストールされている必要があります。

パラメーターのプロパティ

型:ContentDeploymentSqlSnapshotSetting
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値: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」を参照してください。