Start-CMContentDistribution

モジュール:

ConfigurationManager

コンテンツを配布ポイントに配布します。

構文

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DisableContentDependencyDetection]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     -ApplicationId <String[]>
     [-CollectionName <String[]>]
     [-DisableContentDependencyDetection]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     -ApplicationName <String[]>
     [-CollectionName <String[]>]
     [-DisableContentDependencyDetection]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     -BootImageId <String[]>
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     -BootImageName <String[]>
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     -DeploymentPackageId <String[]>
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     -DeploymentPackageName <String[]>
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -DriverPackageId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -DriverPackageName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -InputObject <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemImage <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemImageId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemImageName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemInstallerId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemInstallerName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -PackageId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -PackageName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -TaskSequenceId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -TaskSequenceName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

このコマンドレットを使用して、サイト サーバー上のコンテンツ ライブラリから配布ポイントにコンテンツを配布します。

このコマンドレットを使用して、次の配置可能なオブジェクトのコンテンツを配布できます。

• アプリケーション
• レガシ パッケージ
• ソフトウェア更新プログラムの展開パッケージ
• ドライバー パッケージ
• OS イメージ
• OS アップグレード パッケージ
• ブート イメージ
• タスク シーケンスによって参照されるコンテンツ

配布ポイント、配布ポイント グループ、または配布ポイント グループに関連付けられているコレクションにコンテンツを配布できます。

詳細については、「 Configuration Manager でのコンテンツの展開と管理」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: ブート イメージを配布する

このコマンドは、ID CM200004 を持つブート イメージを CMDIV-TSQA04.CORP.CONTOSO.COM という名前の配布ポイントに配布します。

Start-CMContentDistribution -BootImageId "CM200004" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM"

パラメーター

-ApplicationId

配布するアプリケーション ID の配列を指定します。 これらの ID は、文字列としての GUID です。

既定では、Configuration Manager は依存アプリケーションのコンテンツも配布します。 この動作を無効にするには、 DisableContentDependencyDetection パラメーターを 使用します。

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ApplicationName

配布するアプリケーション名の配列を指定します。

既定では、Configuration Manager は依存アプリケーションのコンテンツも配布します。 この動作を無効にするには、 DisableContentDependencyDetection パラメーターを 使用します。

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-BootImageId

配布するブート イメージ ID の配列を指定します。 たとえば、「 "XYZ00015" 」のように入力します。

型:	String[]
Aliases:	BootImageIds
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-BootImageName

配布するブート イメージ名の配列を指定します。

型:	String[]
Aliases:	BootImageNames
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CollectionName

Configuration Manager コレクション名の配列を指定します。 このコレクションを使用して、コンテンツを配布する配布ポイントをターゲットにします。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentPackageId

配布するソフトウェア更新プログラム展開パッケージ ID の配列を指定します。 たとえば、「 "XYZ00016" 」のように入力します。

型:	String[]
Aliases:	DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentPackageName

配布するソフトウェア更新プログラム展開パッケージ名の配列を指定します。

型:	String[]
Aliases:	DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableContentDependencyDetection

依存アプリのコンテンツを自動的に配布しないようにするには、このパラメーターを追加します。

型:	SwitchParameter
Aliases:	DisableDetectAssociatedContentDependencies
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DistributionPointGroupName

コンテンツを配布する配布ポイント グループ名の配列を指定します。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DistributionPointName

コンテンツを配布する配布ポイント名の配列を指定します。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DriverPackageId

配布するドライバー パッケージ ID の配列を指定します。 たとえば、「 "XYZ00017" 」のように入力します。

型:	String[]
Aliases:	DriverPackageIds
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DriverPackageName

配布するドライバー パッケージ名の配列を指定します。

型:	String[]
Aliases:	DriverPackageNames
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

配布するオブジェクトの種類を指定します。 これらのオブジェクトを取得するには、次のいずれかのコマンドレットを使用します。

• アプリケーションの Get-CMApplication
• レガシ パッケージの Get-CMPackage
• ブート イメージの Get-CMBootImage
• ソフトウェア更新プログラムの展開パッケージの Get-CMDeploymentPackage
• ソフトウェア更新グループ内のコンテンツの Get-CMSoftwareUpdateGroup
• ドライバー パッケージの Get-CMDriverPackage
• OS イメージの Get-CMOperatingSystemImage
• OS アップグレード パッケージの Get-CMOperatingSystemInstaller
• タスク シーケンスによって参照されるコンテンツの Get-CMTaskSequence

型:	IResultObject
Aliases:	Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-OperatingSystemImage

配布する OS イメージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMOperatingSystemImage コマンドレットを 使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OperatingSystemImageId

配布する OS イメージ ID の配列を指定します。 たとえば、「 "XYZ00018" 」のように入力します。

型:	String[]
Aliases:	OperatingSystemImageIds
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OperatingSystemImageName

配布する OS イメージ名の配列を指定します。

型:	String[]
Aliases:	OperatingSystemImageNames
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OperatingSystemInstallerId

配布する OS アップグレード パッケージ ID の配列を指定します。 たとえば、「 "XYZ00019" 」のように入力します。

型:	String[]
Aliases:	OperatingSystemInstallerIds
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OperatingSystemInstallerName

配布する OS アップグレード パッケージ名の配列を指定します。

型:	String[]
Aliases:	OperatingSystemImageInstallerNames
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PackageId

配布するレガシ パッケージ ID の配列を指定します。 たとえば、「 "XYZ00020" 」のように入力します。

型:	String[]
Aliases:	PackageIds
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PackageName

配布するレガシ パッケージ名の配列を指定します。

型:	String[]
Aliases:	PackageNames
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TaskSequenceId

参照コンテンツを配布するタスク シーケンス ID の配列を指定します。 たとえば、「 "XYZ00021" 」のように入力します。

型:	String[]
Aliases:	TaskSequenceIds
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TaskSequenceName

参照先のコンテンツを配布するタスク シーケンス名の配列を指定します。

型:	String[]
Aliases:	TaskSequenceNames
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Get-CMApplication
• Get-CMBootImage
• Get-CMDeploymentPackage
• Get-CMDriverPackage
• Get-CMOperatingSystemImage
• Get-CMOperatingSystemInstaller
• Get-CMPackage
• Get-CMTaskSequence
• Remove-CMContentDistribution
• Invoke-CMContentValidation
• Update-CMDistributionPoint