Set-CMDriver
變更設備磁碟機的設定。
Syntax
Set-CMDriver
[-AddAdministrativeCategory <IResultObject[]>]
[-AddBootImagePackage <IResultObject[]>]
[-AddDriverPackage <IResultObject[]>]
[-AddSupportedPlatformName <String[]>]
[-AdministrativeCategory <IResultObject[]>]
[-ClearAdministrativeCategory]
[-ClearSupportedPlatformName]
[-Description <String>]
[-DriverSource <String>]
[-EnableAndAllowInstall <Boolean>]
-InputObject <IResultObject>
[-NewName <String>]
[-PassThru]
[-RemoveAdministrativeCategory <IResultObject[]>]
[-RemoveBootImagePackage <IResultObject[]>]
[-RemoveDriverPackage <IResultObject[]>]
[-RemoveSupportedPlatformName <String[]>]
[-RunOnAnyPlatform]
[-SupportedPlatformName <String[]>]
[-UpdateBootImageDistributionPoint <Boolean>]
[-UpdateDriverDistributionPoint <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriver
[-AddAdministrativeCategory <IResultObject[]>]
[-AddBootImagePackage <IResultObject[]>]
[-AddDriverPackage <IResultObject[]>]
[-AddSupportedPlatformName <String[]>]
[-AdministrativeCategory <IResultObject[]>]
[-ClearAdministrativeCategory]
[-ClearSupportedPlatformName]
[-Description <String>]
[-DriverSource <String>]
[-EnableAndAllowInstall <Boolean>]
-Id <String>
[-NewName <String>]
[-PassThru]
[-RemoveAdministrativeCategory <IResultObject[]>]
[-RemoveBootImagePackage <IResultObject[]>]
[-RemoveDriverPackage <IResultObject[]>]
[-RemoveSupportedPlatformName <String[]>]
[-RunOnAnyPlatform]
[-SupportedPlatformName <String[]>]
[-UpdateBootImageDistributionPoint <Boolean>]
[-UpdateDriverDistributionPoint <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDriver
[-AddAdministrativeCategory <IResultObject[]>]
[-AddBootImagePackage <IResultObject[]>]
[-AddDriverPackage <IResultObject[]>]
[-AddSupportedPlatformName <String[]>]
[-AdministrativeCategory <IResultObject[]>]
[-ClearAdministrativeCategory]
[-ClearSupportedPlatformName]
[-Description <String>]
[-DriverSource <String>]
[-EnableAndAllowInstall <Boolean>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-RemoveAdministrativeCategory <IResultObject[]>]
[-RemoveBootImagePackage <IResultObject[]>]
[-RemoveDriverPackage <IResultObject[]>]
[-RemoveSupportedPlatformName <String[]>]
[-RunOnAnyPlatform]
[-SupportedPlatformName <String[]>]
[-UpdateBootImageDistributionPoint <Boolean>]
[-UpdateDriverDistributionPoint <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-CMDriver Cmdlet會變更驅動程式類別目錄中設備磁碟機的設定。
注意事項
從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:修改驅動程式
PS XYZ:\> $Driver = Get-CMDriver -Name "cdrom.sys"
PS XYZ:\> Set-CMDriver -InputObject $Driver -NewName "testDriver" -Description "Test configuration" -EnableAndAllowInstall $True -RunOnAnyPlatform $True
第一個命令會使用 Get-CMDriver Cmdlet 取得名為 cdrom.sys 的設備磁碟機。 命令會將該物件儲存在$Driver變數中。
第二個命令會重新命名驅動程式,並新增描述。 命令會指定 EnableAndAllowInstall 和 RunOnAnyPlatform 參數的值。
範例 2:使用管線修改驅動程式
PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $True
此命令會取得名為 cdrom.sys 的驅動程式,然後使用管線運算子將它傳遞至目前的 Cmdlet。 目前的 Cmdlet 會重新命名驅動程式,並新增描述。 命令會指定 EnableAndAllowInstall 和 RunOnAnyPlatform 的值。
參數
-AddAdministrativeCategory
指定這個 Cmdlet 新增至驅動程式的系統管理類別目錄物件陣列。 若要取得系統管理類別物件,請使用 Get-CMCategory Cmdlet。
Type: | IResultObject[] |
Aliases: | AddAdministrativeCategories |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddBootImagePackage
指定開機映射物件的陣列。 使用此參數來指定可安裝設備磁碟機的開機映射。 若要取得開機映射物件,請使用 Get-CMBootImage Cmdlet。
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddDriverPackage
指定驅動程式套件物件的陣列。 使用此參數來指定Configuration Manager用來散發設備磁碟機的驅動程式套件。 若要取得驅動程式套件物件,請使用 Get-CMDriverPackage Cmdlet。
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSupportedPlatformName
{{ Fill AddSupportedPlatformName Description }}
Type: | String[] |
Aliases: | AddSupportedPlatformNames |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AdministrativeCategory
指定系統管理類別的陣列。 將設備磁碟機指派給系統管理類別以進行篩選,例如桌面或筆記本類別。
若要取得系統管理類別物件,請使用 Get-CMCategory Cmdlet。
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearAdministrativeCategory
表示此 Cmdlet 會從驅動程式中移除所有系統管理類別物件。
Type: | SwitchParameter |
Aliases: | ClearAdministrativeCategories |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearSupportedPlatformName
{{ Fill ClearSupportedPlatformName Description }}
Type: | SwitchParameter |
Aliases: | ClearSupportedPlatformNames |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定設備磁碟機的描述。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverSource
指定驅動程式套件來源位置。 當您建立驅動程式套件時,套件的來源位置必須指向另一個驅動程式套件未使用的空白網路共用。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAndAllowInstall
指出Configuration Manager是否啟用驅動程式,並允許電腦安裝驅動程式。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此參數會處理萬用字元,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
指定設備磁碟機的識別碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定驅動程式物件。 若要取得驅動程式物件,請使用 Get-CMDriver Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定設備磁碟機的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
指定設備磁碟機的新名稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
傳回代表驅動程式的 物件。 根據預設,這個 Cmdlet 不會產生任何輸出。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveAdministrativeCategory
指定此 Cmdlet 從驅動程式中移除的系統管理類別目錄物件陣列。 若要取得系統管理類別物件,請使用 Get-CMCategory。
Type: | IResultObject[] |
Aliases: | RemoveAdministrativeCategories |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveBootImagePackage
指定開機映射物件的陣列。 使用此參數來移除可安裝設備磁碟機的開機映射。 若要取得開機映射物件,請使用 Get-CMBootImage Cmdlet。
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveDriverPackage
指定驅動程式套件物件的陣列。 使用此參數來移除Configuration Manager用來散發設備磁碟機的驅動程式套件。 若要取得驅動程式套件物件,請使用 Get-CMDriverPackage Cmdlet。
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSupportedPlatformName
{{ Fill RemoveSupportedPlatformName Description }}
Type: | String[] |
Aliases: | RemoveSupportedPlatformNames |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunOnAnyPlatform
表示設備磁碟機可以在所有平臺上執行。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SupportedPlatformName
指定設備磁碟機可以執行的平臺名稱陣列。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateBootImageDistributionPoint
指出Configuration Manager是否更新其發佈點上的開機映射,以新增驅動程式。
Type: | Boolean |
Aliases: | UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateDriverDistributionPoint
指出當設備磁碟機新增至驅動程式套件時,Configuration Manager更新發佈點。
Type: | Boolean |
Aliases: | UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應