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變數中。

第二個命令會重新命名驅動程式,並新增描述。 命令會指定 EnableAndAllowInstallRunOnAnyPlatform 參數的值。

範例 2:使用管線修改驅動程式

PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $True

此命令會取得名為 cdrom.sys 的驅動程式,然後使用管線運算子將它傳遞至目前的 Cmdlet。 目前的 Cmdlet 會重新命名驅動程式,並新增描述。 命令會指定 EnableAndAllowInstallRunOnAnyPlatform 的值。

參數

-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