Set-CMPackage

モジュール:

ConfigurationManager

パッケージを変更します。

構文

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-InputObject] <IResultObject>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   -Id <String>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

パッケージの設定を変更するには、このコマンドレットを使用します。 詳細については、「 Configuration Manager のパッケージとプログラム」を参照してください。

注:

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

例

例 1: パッケージの名前を変更し、説明を追加する

このコマンドは、ID を持つパッケージの名前を ScriptsPackage02 にST120001し、説明を追加します。

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

例 2: パッケージソースパスを変更する

最初のコマンドは、ID ST120001を持つパッケージを取得し、結果を $Pkg 変数に格納します。 2 番目のコマンドは、パッケージのソース パスを変更します。

$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"

パラメーター

-Confirm

コマンドレットを実行する前に確認を求めるメッセージを表示するには、このパラメーターを追加します。

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

-CopyToPackageShareOnDistributionPoint

クライアントは常に配布ポイントからパッケージをダウンロードできます。 このパラメーターを $true に設定すると、サイトは配布ポイント上の名前付きネットワーク共有を介して使用できるようにします。 CustomPackageShareName を使用して、カスタム共有名を指定します。

このオプションを有効にすると、配布ポイントにさらに多くの領域が必要になります。 このパッケージを配布するすべての配布ポイントに適用されます。

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

-CustomPackageShareName

CopyToPackageShareOnDistributionPoint を有効にした場合は、このパラメーターを使用して共有名をカスタマイズできます。 最大長は 127 文字で、次の文字を含めることはできません: " / [ ] : | < > + = ; , ? *。 共有名とフォルダー名を指定できますが、それぞれの最大文字数は 80 文字です。 たとえば、「 ShareName\FolderName 」のように入力します。

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

-Description

パッケージの識別に役立つ省略可能な説明を指定します。 最大 128 文字を使用できます。

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

-DisableWildcardHandling

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

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

-DisconnectUserFromDistributionPoint

このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectEnabled プロパティを設定します。

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

-DisconnectUserFromDistributionPointMins

このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectDelay プロパティを設定します。

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

-DisconnectUserFromDistributionPointRetry

このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectNumRetries プロパティを設定します。

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

-DistributionPointUpdateSchedule

スケジュールに従って配布ポイントを更新するには、このパラメーターを使用します。 schedule オブジェクトを取得するには、 New-CMSchedule コマンドレットを 使用します。

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

-EnableBinaryDeltaReplication

バイナリ差分レプリケーション (BDR) を有効にするには、このパラメーターを $true に設定します。 詳細については、「 Configuration Manager でのコンテンツ管理の基本的な概念」を参照してください。

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

-ForceWildcardHandling

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

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

-Id

構成するパッケージの ID を指定します。 この値は、標準パッケージ ID です (例: XYZ00020)。

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

-InputObject

構成するパッケージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMPackage コマンドレットを使用します。

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

-Language

パッケージの言語文字列を指定します。 言語バージョンを識別するために使用する形式では、最大 32 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。 たとえば、英語版とドイツ語版の同じパッケージを使用できます。

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

-Manufacturer

ソフトウェアの製造元名を指定します。 最大 32 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。

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

-MifFileName

パッケージの状態を含む管理情報形式 (MIF) ファイルの名前を指定します。 ファイル名拡張子は .mifする必要があります。 状態 MIF ファイルを使用して、詳細な状態レポートを生成します。 状態 MIF ファイルを生成するには、アプリケーションで InstallStatusMIF 関数を呼び出す必要があります。 詳細については、「 Status MIF Functions」を参照してください。

このパラメーターを設定すると、クライアントが展開を実行するときに、Configuration Manager クライアントは、指定したインストール状態 MIF ファイルの %TEMP% ディレクトリまたは %windir% ディレクトリを検索します。 インストール状態は、プログラムが正常に実行されたかどうかを示します。

クライアントがファイルを見つけられない場合は、それらのディレクトリ内のすべての MIF ファイルを検索します。 MifName、MifPublisher、MifVersion に指定した値と、MIF ファイルで指定する値を大文字と小文字を区別しない比較が行われます。 クライアントが一致するものを見つけた場合は、MIF ファイルがプログラムのインストール状態として指定した状態を使用します。 一致するものが見つからない場合、または MifFileName を指定しない場合、クライアントはプログラム終了コードを使用してプログラムのインストール状態を設定します。 終了コード 0 は、プログラムが正常に実行されたことを示します。 その他の値は、アプリケーション固有のエラー コードを示します。

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

-MifName

MIF マッチング用のパッケージの名前を指定します (最大 50 文字)。 詳細については、 MifFileName パラメーターに関するページを参照してください。

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

-MifPublisher

MIF マッチング用のパッケージのソフトウェア発行元 (最大 32 文字) を指定します。 詳細については、 MifFileName パラメーターに関するページを参照してください。

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

-MifVersion

MIF 照合用のパッケージのバージョン番号を指定します(最大 32 文字)。 詳細については、 MifFileName パラメーターに関するページを参照してください。

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

-MulticastAllow

このパラメーターを $true に設定して、このパッケージをマルチキャスト経由で転送できるようにします。 詳細については、「 マルチキャストを使用して Configuration Manager を使用してネットワーク経由で Windows を展開する」を参照してください。

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

-MulticastEncrypt

MulticastAllow を有効にする場合は、このパラメーターを $true に設定してマルチキャスト パッケージを暗号化します。

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

-MulticastTransferOnly

MulticastAllow を有効にする場合は、このパラメーターを $true に設定して、マルチキャスト経由でのみこのドライバー パッケージを転送します。

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

-Name

パッケージ名を指定します。 最大 250 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。

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

-NewName

パッケージの名前を変更するには、このパラメーターを使用します。

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

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-Path

パッケージにソース ファイルが含まれている場合は、ファイルの場所を指定します。 サイト サーバー上の完全なローカル パスまたはネットワーク パスを指定できます。 この場所には、スクリプトを含め、プログラムで実行する必要があるすべてのファイルとサブディレクトリが含まれていることを確認します。

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

-PersistContentInCache

このパッケージのコンテンツをクライアント キャッシュから除外して他のコンテンツの領域を作り出したくない場合は、このパラメーターを $true に設定してクライアント キャッシュに保持します。

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

-PrestageBehavior

事前設定されたコンテンツの配布ポイントを有効にする場合の動作を指定します。

• ManualCopy: このパッケージ内のコンテンツを配布ポイントに手動でコピーします。
• DownloadDelta: コンテンツの変更のみを配布ポイントにダウンロードする
• OnDemand: パッケージが配布ポイントに割り当てられると、コンテンツが自動的にダウンロードされます

詳細については、「 事前設定されたコンテンツを使用する」を参照してください。

型:	PrestageBehavior
指定可能な値:	ManualCopy, DownloadDelta, OnDemand
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Priority

サイトが他のサイトとこのサイトの配布ポイントにコンテンツを送信する順序を指定します。

サイトは、通常または低優先度のパッケージの前に優先度の高いコンテンツを送信します。 優先度が等しいパッケージは、作成された順序で送信されます。

型:	Priorities
Aliases:	DistributionPriority
指定可能な値:	High, Normal, Low
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SendToPreferredDistributionPoint

優先配布ポイントへのオンデマンド コンテンツ配布を有効にする場合は、このパラメーターを $true に設定します。 この設定を有効にすると、クライアントがパッケージのコンテンツを要求し、そのコンテンツが配布ポイントで使用できない場合、管理ポイントはコンテンツを配布します。 詳細については、「 オンデマンド コンテンツの配布」を参照してください。

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

-Version

ソフトウェアのバージョン番号を指定します。 この文字列の最大長は 32 文字です。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Export-CMPackage
• Get-CMPackage
• Import-CMPackage
• New-CMPackage
• Remove-CMPackage
• Configuration Manager のパッケージとプログラム