Set-CMPackage
パッケージを変更します。
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 コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
このコマンドは、ID を持つパッケージの名前を ScriptsPackage02 にST120001し、説明を追加します。
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."
最初のコマンドは、ID ST120001を持つパッケージを取得し、結果を $Pkg 変数に格納します。 2 番目のコマンドは、パッケージのソース パスを変更します。
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"
コマンドレットを実行する前に確認を求めるメッセージを表示するには、このパラメーターを追加します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
クライアントは常に配布ポイントからパッケージをダウンロードできます。 このパラメーターを $true に設定すると、サイトは配布ポイント上の名前付きネットワーク共有を介して使用できるようにします。 CustomPackageShareName を使用して、カスタム共有名を指定します。
このオプションを有効にすると、配布ポイントにさらに多くの領域が必要になります。 このパッケージを配布するすべての配布ポイントに適用されます。
型: | Boolean |
Aliases: | ShareContent, CopyToPackageShareOnDistributionPoints |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
CopyToPackageShareOnDistributionPoint を有効にした場合は、このパラメーターを使用して共有名をカスタマイズできます。 最大長は 127 文字で、次の文字を含めることはできません: " / [ ] : | < > + = ; , ? *
。 共有名とフォルダー名を指定できますが、それぞれの最大文字数は 80 文字です。 たとえば、「 ShareName\FolderName
」のように入力します。
型: | String |
Aliases: | ShareName |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
パッケージの識別に役立つ省略可能な説明を指定します。 最大 128 文字を使用できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectEnabled プロパティを設定します。
型: | Boolean |
Aliases: | ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectDelay プロパティを設定します。
型: | UInt32 |
Aliases: | ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectNumRetries プロパティを設定します。
型: | UInt32 |
Aliases: | ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
スケジュールに従って配布ポイントを更新するには、このパラメーターを使用します。 schedule オブジェクトを取得するには、 New-CMSchedule コマンドレットを 使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
バイナリ差分レプリケーション (BDR) を有効にするには、このパラメーターを $true に設定します。 詳細については、「 Configuration Manager でのコンテンツ管理の基本的な概念」を参照してください。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
構成するパッケージの ID を指定します。 この値は、標準パッケージ ID です (例: XYZ00020
)。
型: | String |
Aliases: | PackageId |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
構成するパッケージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMPackage コマンドレットを使用します。
型: | IResultObject |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
パッケージの言語文字列を指定します。 言語バージョンを識別するために使用する形式では、最大 32 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。 たとえば、英語版とドイツ語版の同じパッケージを使用できます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
ソフトウェアの製造元名を指定します。 最大 32 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
パッケージの状態を含む管理情報形式 (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 |
MIF マッチング用のパッケージの名前を指定します (最大 50 文字)。 詳細については、 MifFileName パラメーターに関するページを参照してください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
MIF マッチング用のパッケージのソフトウェア発行元 (最大 32 文字) を指定します。 詳細については、 MifFileName パラメーターに関するページを参照してください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
MIF 照合用のパッケージのバージョン番号を指定します(最大 32 文字)。 詳細については、 MifFileName パラメーターに関するページを参照してください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このパラメーターを $true に設定して、このパッケージをマルチキャスト経由で転送できるようにします。 詳細については、「 マルチキャストを使用して Configuration Manager を使用してネットワーク経由で Windows を展開する」を参照してください。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
MulticastAllow を有効にする場合は、このパラメーターを $true に設定してマルチキャスト パッケージを暗号化します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
MulticastAllow を有効にする場合は、このパラメーターを $true に設定して、マルチキャスト経由でのみこのドライバー パッケージを転送します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
パッケージ名を指定します。 最大 250 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
パッケージの名前を変更するには、このパラメーターを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
パッケージにソース ファイルが含まれている場合は、ファイルの場所を指定します。 サイト サーバー上の完全なローカル パスまたはネットワーク パスを指定できます。 この場所には、スクリプトを含め、プログラムで実行する必要があるすべてのファイルとサブディレクトリが含まれていることを確認します。
型: | String |
Aliases: | PackageSourcePath |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
このパッケージのコンテンツをクライアント キャッシュから除外して他のコンテンツの領域を作り出したくない場合は、このパラメーターを $true に設定してクライアント キャッシュに保持します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
事前設定されたコンテンツの配布ポイントを有効にする場合の動作を指定します。
-
ManualCopy
: このパッケージ内のコンテンツを配布ポイントに手動でコピーします。 -
DownloadDelta
: コンテンツの変更のみを配布ポイントにダウンロードする -
OnDemand
: パッケージが配布ポイントに割り当てられると、コンテンツが自動的にダウンロードされます
詳細については、「 事前設定されたコンテンツを使用する」を参照してください。
型: | PrestageBehavior |
指定可能な値: | ManualCopy, DownloadDelta, OnDemand |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
サイトが他のサイトとこのサイトの配布ポイントにコンテンツを送信する順序を指定します。
サイトは、通常または低優先度のパッケージの前に優先度の高いコンテンツを送信します。 優先度が等しいパッケージは、作成された順序で送信されます。
型: | Priorities |
Aliases: | DistributionPriority |
指定可能な値: | High, Normal, Low |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
優先配布ポイントへのオンデマンド コンテンツ配布を有効にする場合は、このパラメーターを $true に設定します。 この設定を有効にすると、クライアントがパッケージのコンテンツを要求し、そのコンテンツが配布ポイントで使用できない場合、管理ポイントはコンテンツを配布します。 詳細については、「 オンデマンド コンテンツの配布」を参照してください。
型: | Boolean |
Aliases: | SendToPreferredDistributionPoints |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
ソフトウェアのバージョン番号を指定します。 この文字列の最大長は 32 文字です。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、バージョンの各パラメーターを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
System.Object