Import-CMDriver

  • リファレンス
モジュール:
ConfigurationManager

ドライバー カタログにデバイス ドライバーをインポートします。

構文

Import-CMDriver
      [-AdministrativeCategory <IResultObject[]>]
      [-AdministrativeCategoryName <String[]>]
      [-BootImagePackage <IResultObject[]>]
      [-DriverPackage <IResultObject[]>]
      [-EnableAndAllowInstall <Boolean>]
      [-ImportDuplicateDriverOption <ImportDuplicateDriverOption>]
      [-ImportFolder]
      -Path <String>
      [-SupportedPlatform <IResultObject[]>]
      [-SupportedPlatformName <String[]>]
      [-UpdateBootImageDistributionPoint <Boolean>]
      [-UpdateDriverPackageDistributionPoint <Boolean>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Import-CMDriver コマンドレットは、Configuration Manager のドライバー カタログに 1 つ以上のデバイス ドライバーをインポートします。 デバイス ドライバーをカタログにインポートするときに、ドライバー パッケージまたはブート イメージ パッケージにデバイス ドライバーを追加できます。

デバイス ドライバーのインポート プロセスの一環として、Configuration Manager はデバイスに関連付けられている次の情報を読み取ります。

  • プロバイダー
  • クラス
  • バージョン
  • 署名
  • サポートされているハードウェア
  • サポートされているプラットフォーム

既定では、ドライバーには、サポートされている最初のハードウェア デバイスの名前が付けられます。 デバイス ドライバーの名前を変更するには、Set-CMDriver コマンドレットの -NewName パラメーターを使用します。 サポートされているプラットフォームの一覧は、ドライバーの INF ファイル内の情報に基づいています。 この情報の精度は異なる場合があるため、ドライバー カタログにインポートした後、デバイス ドライバーがサポートされていることを手動で確認します。

注:

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

例

例 1: パス内のすべてのデバイス ドライバーをインポートする

このコマンドは、ネットワーク パス \\Server1\Driverにあるすべてのデバイス ドライバーをインポートします。

Import-CMDriver -Path "\\Server1\Driver" -ImportFolder

例 2: 名前でデバイス ドライバーをインポートする

このコマンドは、 driver.inf という名前のドライバーをネットワーク パス \\Server1\Driverからインポートします。

Import-CMDriver -Path "\\Server1\Driver\driver.inf"

パラメーター

-AdministrativeCategory

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

デスクトップやノートブックなどのフィルター処理を行うために、デバイス ドライバーをカテゴリに割り当てます。

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

-AdministrativeCategoryName

AdministrativeCategory パラメーターを使用してカテゴリのオブジェクトを取得して指定する代わりに、このパラメーターを使用してカテゴリの名前を指定します。 カテゴリ名の配列を使用することもできます。

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

-BootImagePackage

ブート イメージ オブジェクトの配列を指定します。 このオブジェクトを取得するには、 Get-CMBootImage コマンドレットを 使用します。

インポートされたドライバーを指定したブート イメージに追加するには、このパラメーターを使用します。

Windows PE (WinPE) で起動するために必要なドライバーのみを追加します。

  • ブート イメージに追加するドライバーが、ブート イメージのアーキテクチャと一致していることを確認します。

  • WinPE には既に多数のドライバーが組み込まれています。 WinPE に含まれていないネットワーク ドライバーとストレージ ドライバーのみを追加します。

  • WinPE に他のドライバーの要件がない限り、ネットワーク ドライバーとストレージ ドライバーのみをブート イメージに追加します。

  • 有効なデジタル署名を持つドライバーを使用することをお勧めします。

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-DriverPackage

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

このパラメーターを使用して、インポートされたドライバーを指定されたドライバー パッケージに追加します。

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

-EnableAndAllowInstall

ドライバーを有効にし、[ ドライバーの自動適用] タスク シーケンスの手順でクライアントがドライバーをインストールできるようにします。

ドライバー パッケージに追加されたドライバーは影響を受けません。

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

-ForceWildcardHandling

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

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

-ImportDuplicateDriverOption

Configuration Manager が重複するデバイス ドライバーを管理する方法を指定します。

  • AppendCategory: ドライバーをインポートし、既存のカテゴリに新しいカテゴリを追加する - KeepExistingCategory: ドライバーをインポートし、既存のカテゴリを保持します
  • NotImport: ドライバーをインポートしない
  • OverwriteCategory: ドライバーをインポートし、既存のカテゴリを上書きします
型:ImportDuplicateDriverOption
指定可能な値:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ImportFolder

このパラメーターを追加して、ターゲット フォルダー内のすべてのデバイス ドライバーをインポートします。

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

-Path

インポートするドライバー ファイルへのパスを指定します。

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

-SupportedPlatform

デバイス ドライバーが適用され、実行できるサポートされているプラットフォーム オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSupportedPlatform コマンドレットを 使用します。

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

-SupportedPlatformName

デバイス ドライバーを実行できる、サポートされているプラットフォーム名の配列を指定します。 たとえば、「 "All Windows 10 (64-bit)" 」のように入力します。

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

-UpdateBootImageDistributionPoint

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

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

-UpdateDriverPackageDistributionPoint

DriverPackage パラメーターを使用する場合は、このパラメーターを $true に設定して、割り当てられた配布ポイントのドライバー パッケージを更新します。

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

-WhatIf

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

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

入力

None

出力

IResultObject