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

輸出

系統.物件