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 のパッケージとプログラム」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: パッケージの名前を変更し、説明を追加する
このコマンドは 、ID ST120001 を持つパッケージの名前を ScriptsPackage02 に変更し、説明を追加します。
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
コマンドレットを実行する前に確認を求めるメッセージを表示するには、このパラメーターを追加します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
クライアントは常に配布ポイントからパッケージをダウンロードできます。 このパラメーターを $trueすると 、 サイトは配布ポイント上の名前付きネットワーク共有経由で使用できます。 カスタム共有名を指定するには、CustomPackageShareNameを使用します。
このオプションを有効にすると、配布ポイントに必要な領域が多くなされます。 このパッケージは、このパッケージを配布する配布ポイントすべてに適用されます。
Type: | Boolean |
Aliases: | ShareContent, CopyToPackageShareOnDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomPackageShareName
CopyToPackageShareOnDistributionPointを有効にした場合は、このパラメーターを使用して共有名をカスタマイズできます。 最大長は 127 文字で、次の文字を含めることはできません " / [ ] : | < > + = ; , ? *
。 共有名とフォルダー名を指定できますが、それぞれの最大文字数は 80 文字です。 たとえば、ShareName\FolderName
などです。
Type: | String |
Aliases: | ShareName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
パッケージの識別に役立つオプションの説明を指定します。 最大 128 文字を使用できます。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisconnectUserFromDistributionPoint
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectEnabled プロパティを設定します。
Type: | Boolean |
Aliases: | ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectDelay プロパティを設定します。
Type: | UInt32 |
Aliases: | ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetry
このオプションは非推奨です。 ドライバー パッケージの ForcedDisconnectNumRetries プロパティを設定します。
Type: | UInt32 |
Aliases: | ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
スケジュールで配布ポイントを更新するには、このパラメーターを使用します。 スケジュール オブジェクトを取得するには 、New-CMSchedule コマンドレットを使用 します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
バイナリ差分レプリケーション (BDR) $true を有効にするには、このパラメーターをこのパラメーターに設定します。 詳細については 、「Configuration Manager のコンテンツ管理の基本的な概念」を参照してください。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
構成するパッケージの ID を指定します。 この値は、次の標準的なパッケージ ID です XYZ00020
。
Type: | String |
Aliases: | PackageId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
構成するパッケージ オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMPackage コマンドレットを使用 します。
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Language
パッケージの言語文字列を指定します。 言語のバージョンを識別するために使用する形式では、最大 32 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、およびバージョン の各パラメーターを使用します。 たとえば、英語版と同じパッケージのドイツ語バージョンを使用できます。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Manufacturer
ソフトウェアの製造元名を指定します。 最大 32 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、およびバージョン の各パラメーターを使用します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifFileName
パッケージの状態を含む管理情報形式 (MIF) ファイルの名前を指定します。 ファイル名の拡張子は、 である必要があります .mif
。 状態 MIF ファイルを使用して、詳細な状態レポートを生成します。 状態 MIF ファイルを生成するには、アプリケーションで InstallStatusMIF 関数を呼び出す必要があります。 詳細については 、「Status MIF Functions」を参照してください。
このパラメーターを設定すると、クライアントが展開を実行すると、Configuration Manager クライアントは、指定したインストール状態 MIF ファイルのディレクトリまたはディレクトリ %TEMP%
%windir%
を検索します。 インストール状態は、プログラムが正常に実行されたかどうかを示します。
クライアントがファイルを見つけなかった場合は、それらのディレクトリ内のすべての MIF ファイルを検索します。 MifName、MifPublisher、****および MifVersionに指定した値を、MIF ファイルで指定**** した値と大文字と小文字を区別しない比較を行います。 クライアントが一致を見つけた場合、MIF ファイルがプログラムのインストール状態として指定する状態が使用されます。 一致が見つからなかった場合、または MifFileNameを指定しない場合、クライアントはプログラム終了コードを使用してプログラムのインストール状態を設定します。 終了コード 0 は、プログラムが正常に実行されたことを示します。 その他の値は、アプリケーション固有のエラー コードを示します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifName
MIF 照合のパッケージの名前を最大 50 文字まで指定します。 詳細については 、「MifFileName パラメーター」を参照 してください。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifPublisher
MIF 照合用のパッケージのソフトウェア発行元を最大 32 文字で指定します。 詳細については 、「MifFileName パラメーター」を参照 してください。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MifVersion
MIF 照合用のパッケージのバージョン番号を最大 32 文字まで指定します。 詳細については 、「MifFileName パラメーター」を参照 してください。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MulticastAllow
このパラメーターを [$true] に設定して、このパッケージをマルチキャスト経由で転送できます。 詳細については、「Configuration Manager を使用してネットワーク上にWindowsマルチキャストを使用する」を参照してください。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MulticastEncrypt
MulticastAllow を有効にした場合は、このパラメーターをマルチキャストパッケージ$trueに設定します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MulticastTransferOnly
MulticastAllow を有効にする場合は、このパラメーターをマルチキャスト$trueこのドライバーパッケージのみを転送する場合に設定します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
パッケージ名を指定します。 最大 250 文字を使用できます。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、およびバージョン の各パラメーターを使用します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
パッケージの名前を変更するには、このパラメーターを使用します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
パッケージにソース ファイルが含まれている場合は、ファイルの場所を指定します。 サイト サーバー上の完全なローカル パスまたはネットワーク パスを指定できます。 この場所には、プログラムが実行する必要があるすべてのファイルとサブディレクトリ (スクリプトを含む) が含まれている必要があります。
Type: | String |
Aliases: | PackageSourcePath |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistContentInCache
このパッケージのコンテンツをクライアント キャッシュからエイズアウトして他のコンテンツを保存しない場合は、このパラメーターを $true に設定して、クライアント キャッシュに保持します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrestageBehavior
事前設定されたコンテンツの配布ポイントを有効にした場合の動作を指定します。
ManualCopy
: このパッケージ内のコンテンツを配布ポイントに手動でコピーするDownloadDelta
: 配布ポイントへのコンテンツの変更のみをダウンロードするOnDemand
: パッケージが配布ポイントに割り当てられているときにコンテンツを自動的にダウンロードする
詳細については、「事前設定された コンテンツを使用する」を参照してください。
Type: | PrestageBehavior |
Accepted values: | ManualCopy, DownloadDelta, OnDemand |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Priority
サイトがコンテンツを他のサイトに送信する順序と、このサイトの配布ポイントを指定します。
サイトは、通常または低優先度のパッケージの前に優先度の高いコンテンツを送信します。 優先度が等しいパッケージは、作成順に送信されます。
Type: | Priorities |
Aliases: | DistributionPriority |
Accepted values: | High, Normal, Low |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendToPreferredDistributionPoint
オンデマンド コンテンツ配布を優先配布ポイントに対して有効にする場合は、このパラメーターを [$true] に設定します。 この設定を有効にすると、クライアントがパッケージのコンテンツを要求し、そのコンテンツが配布ポイントで使用できない場合、管理ポイントはコンテンツを配布します。 詳細については、「オンデマンド コンテンツ 配布」を参照してください。
Type: | Boolean |
Aliases: | SendToPreferredDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Version
ソフトウェアのバージョン番号を指定します。 この文字列の最大長は 32 文字です。 パッケージを識別するために、Configuration Manager は言語、製造元、名前、およびバージョン の各パラメーターを使用します。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object