Set-CMDriver

デバイス ドライバーの設定を変更します。

構文

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>]

説明

Set-CMDriver コマンドレットは、ドライバー カタログ内のデバイス ドライバーの設定を変更します。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: 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 コマンドレットを使用して cdrom.sys という名前のデバイス ドライバーを取得します。 コマンドは、そのオブジェクトを $Driver 変数に格納します。

2 番目のコマンドは、ドライバーの名前を変更し、説明を追加します。 コマンドは 、EnableAndAllowInstall パラメーターと RunOnAnyPlatform パラメーターの値を 指定します。

例 2: パイプラインを使用してドライバーを変更する

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

このコマンドは、cdrom.sys という名前のドライバーを取得し、パイプライン演算子を使用して現在のコマンドレットに渡します。 現在のコマンドレットは、ドライバーの名前を変更し、説明を追加します。 コマンドは 、EnableAndAllowInstallRunOnAnyPlatform の値を指定します。

パラメーター

-AddAdministrativeCategory

このコマンドレットがドライバーに追加する管理カテゴリ オブジェクトの配列を指定します。 管理カテゴリ オブジェクトを取得するには、 Get-CMCategory コマンドレットを 使用します。

Type:IResultObject[]
Aliases:AddAdministrativeCategories
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddBootImagePackage

ブート イメージ オブジェクトの配列を指定します。 このパラメーターを使用して、デバイス ドライバーをインストールできるブート イメージを指定します。 ブート イメージ オブジェクトを取得するには、 Get-CMBootImage コマンドレットを使用します。

Type:IResultObject[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddDriverPackage

ドライバー パッケージ オブジェクトの配列を指定します。 このパラメーターを使用して、デバイス ドライバーの配布に使用Configuration Managerドライバー パッケージを指定します。 ドライバー パッケージ オブジェクトを取得するには、 Get-CMDriverPackage コマンドレットを 使用します。

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 コマンドレットを 使用します。

Type:IResultObject[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearAdministrativeCategory

このコマンドレットは、すべての管理カテゴリ オブジェクトをドライバーから削除することを示します。

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

コマンドレットを実行する前に確認メッセージを表示します。

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

デバイス ドライバーの ID を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

ドライバー オブジェクトを指定します。 ドライバー オブジェクトを取得するには、 Get-CMDriver コマンドレットを 使用します。

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

ドライバーを表す オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveAdministrativeCategory

このコマンドレットがドライバーから削除する管理カテゴリ オブジェクトの配列を指定します。 管理カテゴリ オブジェクトを取得するには、 Get-CMCategory を使用します。

Type:IResultObject[]
Aliases:RemoveAdministrativeCategories
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveBootImagePackage

ブート イメージ オブジェクトの配列を指定します。 デバイス ドライバーをインストールできるブート イメージを削除するには、このパラメーターを使用します。 ブート イメージ オブジェクトを取得するには、 Get-CMBootImage コマンドレットを使用します。

Type:IResultObject[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveDriverPackage

ドライバー パッケージ オブジェクトの配列を指定します。 このパラメーターを使用して、デバイス ドライバーの配布に使用Configuration Managerドライバー パッケージを削除します。 ドライバー パッケージ オブジェクトを取得するには、 Get-CMDriverPackage コマンドレットを 使用します。

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

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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