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