Set-CMDriverPackage
修改驅動程式套件。
Syntax
Set-CMDriverPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-DriverManufacturer <String>]
[-DriverModel <String>]
[-DriverPackageSource <String>]
-InputObject <IResultObject>
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priority>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-DriverManufacturer <String>]
[-DriverModel <String>]
[-DriverPackageSource <String>]
-Id <String>
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priority>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriverPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetryCount <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-DriverManufacturer <String>]
[-DriverModel <String>]
[-DriverPackageSource <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priority>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 可修改驅動程式套件。
如需詳細資訊,請參閱 在 Configuration Manager 中管理驅動程式。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:設定驅動程式套件的製造商和模型
這個命令會使用識別碼 XYZ00091來設定驅動程式套件的製造商和模型。
Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"
參數
-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: | CopyToPackageShareOnDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomPackageShareName
如果您啟用 CopyToPackageShareOnDistributionPoint,您可以使用此參數自訂共用名稱稱。 最大長度為127個字元,且不能包含下列任何字元: " / [ ] : | < > + = ; , ? *
。 您可以指定共用名稱稱和資料夾名稱,但是每個名稱的最大值為80個字元。 例如,ShareName\FolderName
。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定驅動程式套件的選用描述,以協助您加以識別。
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: | DisconnectUsersFromDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
此選項已被取代。 它會設定驅動程式套件的 ForcedDisconnectDelay 屬性。
Type: | UInt32 |
Aliases: | DisconnectUsersFromDistributionPointsMinutes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetryCount
此選項已被取代。 它會設定驅動程式套件的 ForcedDisconnectNumRetries 屬性。
Type: | UInt32 |
Aliases: | 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 |
-DriverManufacturer
使用此參數來設定裝置的製造商。 最大長度為 100 個字元。
使用 DriverModel 參數。 您可以使用它們來管理驅動程式目錄,以及使用任務順序預快取。 如需詳細資訊,請參閱 設定任務順序的預先緩存內容。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverModel
使用此參數可設定裝置的模型。 最大長度為 100 個字元。
使用 DriverManufacturer 參數。 您可以使用它們來管理驅動程式目錄,以及使用任務順序預快取。 如需詳細資訊,請參閱 設定任務順序的預先緩存內容。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverPackageSource
指定用來建立驅動程式檔案來源之網路位置的檔路徑。
當您建立驅動程式套件時,套件的來源位置必須指向未由另一個驅動程式套件使用的空白網路共用。 SMS 提供者必須具有該位置的「 完全控制 」許可權。
當您新增裝置驅動程式至驅動程式套件時,Configuration Manager 會將其複製到此路徑。 您可以只將已匯入的裝置驅動程式和驅動程式目錄中已啟用的驅動程式套件進行新增。
Type: | String |
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
指定要設定的驅動程式套件物件。 若要取得此物件,請使用 CMDriverPackage Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
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 |
-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: | Priority |
Accepted values: | High, Medium, 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 |
-名稱
指定要設定之驅動程式套件的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-版本
指定驅動程式套件的版本。 這個值是您管理的字串。
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
輸出
系統.物件