Set-CMDriver

モジュール:

ConfigurationManager

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

構文

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 コマンドレットは、ドライバー カタログ内のデバイス ドライバーの設定を変更します。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 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 という名前のドライバーを取得し、パイプライン演算子を使用して現在のコマンドレットに渡します。 現在のコマンドレットは、ドライバーの名前を変更し、説明を追加します。 コマンドは 、EnableAndAllowInstall と RunOnAnyPlatform の値を指定します。

パラメーター

-AddAdministrativeCategory

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

型:	IResultObject[]
Aliases:	AddAdministrativeCategories
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddBootImagePackage

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

型:	IResultObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddDriverPackage

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

型:	IResultObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AddSupportedPlatformName

{{ Fill AddSupportedPlatformName Description }}

型:	String[]
Aliases:	AddSupportedPlatformNames
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AdministrativeCategory

管理カテゴリの配列を指定します。 デバイス ドライバーを管理カテゴリに割り当てて、デスクトップやノートブックのカテゴリなどのフィルター処理を行います。

管理カテゴリ オブジェクトを取得するには、 Get-CMCategory コマンドレットを 使用します。

型:	IResultObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearAdministrativeCategory

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

型:	SwitchParameter
Aliases:	ClearAdministrativeCategories
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClearSupportedPlatformName

{{ Fill ClearSupportedPlatformName Description }}

型:	SwitchParameter
Aliases:	ClearSupportedPlatformNames
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DriverSource

ドライバー パッケージのソースの場所を指定します。 ドライバー パッケージを作成する場合、パッケージのソースの場所は、別のドライバー パッケージで使用されていない空のネットワーク共有を指している必要があります。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableAndAllowInstall

Configuration Manager によってドライバーが有効にされ、コンピューターがドライバーをインストールできるかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

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

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NewName

デバイス ドライバーの新しい名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveAdministrativeCategory

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

型:	IResultObject[]
Aliases:	RemoveAdministrativeCategories
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveBootImagePackage

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

型:	IResultObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveDriverPackage

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

型:	IResultObject[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveSupportedPlatformName

{{ Fill RemoveSupportedPlatformName Description }}

型:	String[]
Aliases:	RemoveSupportedPlatformNames
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RunOnAnyPlatform

デバイス ドライバーがすべてのプラットフォームで実行できることを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SupportedPlatformName

デバイス ドライバーを実行できるプラットフォームの名前の配列を指定します。

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UpdateBootImageDistributionPoint

Configuration Manager が配布ポイントのブート イメージを更新して新しいドライバーを追加するかどうかを示します。

型:	Boolean
Aliases:	UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UpdateDriverDistributionPoint

デバイス ドライバーがドライバー パッケージに追加されたときに、Configuration Manager によって配布ポイントが更新されることを示します。

型:	Boolean
Aliases:	UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Disable-CMDriver
• Enable-CMDriver
• Get-CMDriver
• Import-CMDriver
• Remove-CMDriver
• Get-CMCategory
• Get-CMBootImage
• Get-CMDriverPackage