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 のパッケージとプログラム」を参照してください。

注意

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