Set-CMPackage
修改套件。
Syntax
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:重新命名套件並新增描述
此命令會將 ID 為 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 執行之前,將此參數新增至提示確認。
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
使用此參數可依排程更新發佈點。 若要取得排程物件,請使用 CMSchedule Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
將此參數設為 $true ,啟用二進位差異複寫 (BDR) 。 如需詳細資訊,請參閱 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 |
-InputObject
指定要設定的 package 物件。 若要取得此物件,請使用 CMPackage Cmdlet。
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 |
-MifFileName
指定包含套件狀態 (MIF) 檔案的管理資訊格式名稱。 副檔名必須為 .mif
。 使用狀態 MIF 檔案以產生詳細的狀態報表。 若要產生狀態 MIF 檔案,您的應用程式必須呼叫 InstallStatusMIF 函數。 如需詳細資訊,請參閱 狀態 MIF 函數。
如果您設定此參數,當用戶端執行部署時,Configuration Manager 用戶端 %TEMP%
會在目錄或 %windir%
您指定的安裝狀態 MIF 檔案中查看目錄。 安裝狀態會指出程式是否已順利執行。
如果用戶端找不到檔案,則會搜尋這些目錄中的所有 MIF 檔案。 對您為 MifName、 MifPublisher及 MifVersion 指定的值進行不區分大小寫的比較,以 MIF 檔案所指定的值。 如果用戶端找到相符專案,則會使用 MIF 檔案指定為程式的安裝狀態的狀態。 如果找不到相符專案,或您未指定 MifFileName,用戶端會使用程式的退出碼來設定程式的安裝狀態。 結束代碼零表示程式已順利執行。 任何其他值都表示應用程式的特定錯誤碼。
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 |
-NewName
使用此參數可重新命名套件。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設,此 Cmdlet 可能不會產生任何輸出。
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
指定網站將內容傳送至其他網站和此網站中之發佈點的順序。
在具有 normal 或低優先順序的套件之前,網站會傳送高優先順序內容。 具有相同優先順序的套件會依照建立的順序傳送。
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 |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名稱
指定套件名稱。 您最多可以使用250個字元。 為了識別套件,Configuration Manager 使用 語言、 製造商、 名稱及 版本 參數。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-版本
指定軟體的版本號碼。 此字串的最大長度為32個字元。 為了識別套件,Configuration Manager 使用 語言、 製造商、 名稱及 版本 參數。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-製造商
指定軟體的製造商名稱。 您最多可以使用32個字元。 為了識別套件,Configuration Manager 使用 語言、 製造商、 名稱及 版本 參數。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-識別碼
指定要設定之套件的識別碼。 此值是標準套件識別碼,例如: XYZ00020
。
Type: | String |
Aliases: | PackageId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
系統.物件