Set-CMDriverPackage

模組:

ConfigurationManager

修改驅動程式套件。

語法

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 之前提示您確認。

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

-CopyToPackageShareOnDistributionPoint

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

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

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

-CustomPackageShareName

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

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

-Description

指定驅動程式套件的選擇性描述，以協助您識別它。

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

-DisableWildcardHandling

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

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

-DisconnectUserFromDistributionPoint

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

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

-DisconnectUserFromDistributionPointMins

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

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

-DisconnectUserFromDistributionPointRetryCount

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

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

-DistributionPointUpdateSchedule

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

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

-DriverManufacturer

使用此參數來設定裝置的製造商。 最大長度為 100 個字元。

搭配 DriverModel 參數使用它。 您可以使用它們來管理驅動程序目錄，以及使用工作順序預先快取。 如需詳細資訊， 請參閱設定工作順序的預先快取內容。

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

-DriverModel

使用此參數來設定裝置的模型。 最大長度為 100 個字元。

搭配 DriverManufacturer 參數使用它。 您可以使用它們來管理驅動程序目錄，以及使用工作順序預先快取。 如需詳細資訊， 請參閱設定工作順序的預先快取內容。

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

-DriverPackageSource

指定網路位置的檔案路徑，以取得驅動程式檔案的來源。

當您建立驅動程式套件時，套件的來源位置必須指向另一個驅動程式套件未使用的空白網路共用。 SMS 提供者必須具有該位置的 完整控制權 限。

當您將設備驅動器新增至驅動程式套件時，Configuration Manager 會將它複製到此路徑。 您只能將已匯入且已在驅動程式類別目錄中啟用的設備驅動器新增至驅動程式套件。

類型:	String
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-CMDriverPackage Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	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

指定要設定的驅動程式套件名稱。

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

-NewName

指定驅動程式套件的新名稱。

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

-PassThru

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

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

-PrestageBehavior

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

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

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

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

-Priority

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

網站會先傳送高優先順序的內容，再傳送中低優先順序的套件。 優先順序相等的套件會依其建立順序傳送。

類型:	Priority
接受的值:	High, Medium, Low
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SendToPreferredDistributionPoint

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

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

-Version

指定驅動程式套件的版本。 此值是您管理的字串。

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

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

相關連結

• Export-CMDriverPackage
• Get-CMDriverPackage
• Import-CMDriverPackage
• New-CMDriverPackage
• Remove-CMDriverPackage
• 在 Configuration Manager 中管理驅動程式