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>]

Description

使用此 Cmdlet 來變更封裝的設定。如需詳細資訊，請參閱 Configuration Manager 中的套件和程式。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。如需詳細資訊，請參閱開始使用。

範例

範例 1：重新命名套件並新增描述

此命令會將標識 碼ST120001 的套件重新命名為 ScriptsPackage02 ，並新增描述。

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

範例 2：變更套件來源路徑

第一個命令會取得標識 碼ST120001的套件，並將結果儲存在 $Pkg 變數中。第二個命令會變更封裝來源路徑。

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

參數

-Confirm

新增此參數，以在 Cmdlet 執行之前提示確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CopyToPackageShareOnDistributionPoint

用戶端一律可以從發佈點下載套件。如果您將此參數設定為 $true，月臺會透過發佈點上的具名網路共用提供此參數。使用 CustomPackageShareName 指定自定義共用名。

當您啟用此選項時，發佈點上需要更多空間。它適用於您發佈此套件的所有發佈點。

類型:	Boolean
別名:	ShareContent, CopyToPackageShareOnDistributionPoints
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CustomPackageShareName

如果您啟用 CopyToPackageShareOnDistributionPoint，您可以使用此參數來自定義共用名。最大長度為 127 個字元，且不能包含下列任何字元： " / [ ] : | < > + = ; , ? *。您可以指定共用名和資料夾名稱，但每個名稱的上限為80個字元。例如，ShareName\FolderName。

類型:	String
別名:	ShareName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

指定套件的選擇性描述，以協助您識別它。您最多可以使用 128 個字元。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisconnectUserFromDistributionPoint

此選項已被取代。它會設定驅動程式套件的 ForcedDisconnectEnabled 屬性。

類型:	Boolean
別名:	ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisconnectUserFromDistributionPointMins

此選項已被取代。它會設定驅動程式套件的 ForcedDisconnectDelay 屬性。

類型:	UInt32
別名:	ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisconnectUserFromDistributionPointRetry

此選項已被取代。它會設定驅動程式套件的 ForcedDisconnectNumRetries 屬性。

類型:	UInt32
別名:	ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DistributionPointUpdateSchedule

使用此參數可依排程更新發佈點。若要取得排程物件，請使用 New-CMSchedule Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableBinaryDeltaReplication

將此參數設定為 $true ，以啟用 BDR) (二進位差異複寫。如需詳細資訊，請參閱 Configuration Manager 中內容管理的基本概念。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定要設定之封裝的識別碼。此值是標準套件標識碼，例如： XYZ00020。

類型:	String
別名:	PackageId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定要設定的套件物件。若要取得此物件，請使用 Get-CMPackage Cmdlet。

類型:	IResultObject
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Language

指定封裝的語言字串。您最多可以使用 32 個字元的格式來識別語言版本。為了識別套件，Configuration Manager 會使用語言、 製造商、名稱和版本參數。例如，您可以有英文版本和相同套件的德文版本。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Manufacturer

指定軟體的製造商名稱。您最多可以使用 32 個字元。為了識別套件，Configuration Manager 會使用語言、 製造商、名稱和版本參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MifFileName

指定包含封裝狀態的管理資訊格式 (MIF) 檔的名稱。延伸名稱必須是 .mif。使用狀態MIF檔案來產生詳細的狀態報告。若要產生狀態 MIF 檔案，您的應用程式必須呼叫 InstallStatusMIF 函式。如需詳細資訊，請參閱狀態MIF函式。

如果您設定此參數，當用戶端執行部署時，Configuration Manager 用戶端會在目錄或%windir%目錄中%TEMP%尋找您指定的安裝狀態 MIF 檔案。安裝狀態會指出程式是否成功執行。

如果用戶端找不到檔案，它會搜尋這些目錄中的所有MIF檔案。它會將您為 MifName、 MifPublisher和 MifVersion 指定的值與MIF檔案指定的值進行不區分大小寫的比較。如果用戶端找到相符專案，它會使用MIF檔案指定為程式安裝狀態的狀態。如果找不到相符專案，或未指定 MifFileName，用戶端會使用程式結束代碼來設定程式的安裝狀態。結束代碼為零表示程式已成功執行。任何其他值都表示應用程式特定的錯誤碼。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MifName

指定 MIF 比對的套件名稱，最多 50 個字元。如需詳細資訊，請參閱 MifFileName 參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MifPublisher

指定套件的軟體發行者進行MIF比對，最多32個字元。如需詳細資訊，請參閱 MifFileName 參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MifVersion

指定 MIF 比對的套件版本號碼，最多 32 個字元。如需詳細資訊，請參閱 MifFileName 參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MulticastAllow

將此參數設定為 $true ，以允許透過多播傳輸此套件。如需詳細資訊，請參閱使用多播搭配 Configuration Manager 透過網路部署 Windows。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MulticastEncrypt

如果您啟用 MulticastAllow，請將此參數設定為 $true 以加密多播套件。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MulticastTransferOnly

如果您啟用 MulticastAllow，請將此參數設定 為 $true ，只透過多播傳輸此驅動程式套件。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定封裝名稱。您最多可以使用 250 個字元。為了識別套件，Configuration Manager 會使用語言、 製造商、名稱和版本參數。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NewName

使用此參數來重新命名封裝。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

新增此參數以傳回物件，代表您正在使用的專案。根據預設，此 Cmdlet 可能不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

如果封裝包含原始程序檔，請指定檔案的位置。您可以指定站台伺服器上的完整本機路徑或網路路徑。請確定此位置包含程式需要執行的所有檔案和子目錄，包括任何腳本。

類型:	String
別名:	PackageSourcePath
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PersistContentInCache

如果您不想讓此套件的內容離開用戶端快取，以騰出空間供其他內容使用，請將此參數設定為 $true 將它保存在用戶端快取中。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrestageBehavior

當您啟用預先設定內容的發佈點時，請指定行為：

ManualCopy：手動將此套件中的內容複製到發佈點
DownloadDelta：僅下載發佈點的內容變更
OnDemand：將套件指派給發佈點時自動下載內容

如需詳細資訊，請參閱使用預先設置的內容。

類型:	PrestageBehavior
接受的值:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Priority

指定網站將內容傳送至此網站中其他網站和發佈點的順序。

網站會在一般或低優先順序的套件之前傳送高優先順序的內容。優先順序相等的套件會依其建立順序傳送。

類型:	Priorities
別名:	DistributionPriority
接受的值:	High, Normal, Low
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SendToPreferredDistributionPoint

如果您想要啟用對慣用發佈點的隨選內容發佈，請將此參數設定 為 $true。當您啟用此設定時，如果用戶端要求套件的內容，且內容無法在任何發佈點上使用，則管理點會發佈內容。如需詳細資訊，請參閱隨選內容發佈。

類型:	Boolean
別名:	SendToPreferredDistributionPoints
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Version

指定軟體的版本號碼。此字串的最大長度為32個字元。為了識別套件，Configuration Manager 會使用語言、 製造商、名稱和版本參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

共用方式為