Import-CMDriver

將設備驅動器匯入驅動程序目錄。

語法

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

Description

Import-CMDriver Cmdlet 會將一或多個設備驅動器匯入 Configuration Manager 中的驅動程序類別目錄。 當您將設備驅動器匯入目錄時,可以將設備驅動器新增至驅動程式套件或開機映像套件。

在設備驅動器的匯入程式中,Configuration Manager 會讀取與裝置相關聯的下列資訊:

  • 提供者
  • 類別
  • 版本
  • 簽章
  • 支援的硬體
  • 支援的平臺

根據預設,驅動程式會以它支援的第一個硬體裝置命名。 若要重新命名設備驅動器,請使用 Set-CMDriver Cmdlet 的 -NewName 參數。 支援的平台清單是以驅動程式 INF 檔案中的資訊為基礎。 因為此資訊的精確度可能會有所不同,請在您將設備驅動器匯入驅動程式類別目錄之後,手動確認支援該設備驅動器。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用

範例

範例 1:匯入路徑中的所有設備驅動器

此命令會匯入位於網路路徑 \\Server1\Driver中的所有設備驅動器。

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

範例 2:依名稱匯入設備驅動器

此命令會從網路路徑 匯入名為 driver.inf 的驅動程式 \\Server1\Driver

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

參數

-AdministrativeCategory

指定類別物件的陣列。 若要取得此物件,請使用 Get-CMCategory Cmdlet。

將設備驅動器指派給類別以進行篩選,例如桌面或筆記本。

類型:IResultObject[]
別名:AdministrativeCategories
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AdministrativeCategoryName

不要使用 AdministrativeCategory 參數取得並指定類別目錄的物件,而是使用此參數來直接指定類別的名稱。 您也可以使用類別名稱的陣列。

類型:String[]
別名:AdministrativeCategoryNames
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BootImagePackage

指定開機映像物件的陣列。 若要取得此物件,請使用 Get-CMBootImage Cmdlet。

使用此參數將匯入的驅動程式新增至指定的開機映像。

僅新增 Windows PE (WinPE) 開機所需的驅動程式:

  • 請確定您新增至開機映像的驅動程式符合開機映像的架構。

  • WinPE 已隨附許多內建驅動程式。 只新增 WinPE 中未包含的網路和記憶體驅動程式。

  • 除非 WinPE 中有其他驅動程式的需求,否則請只將網路和記憶體驅動程式新增至開機映像。

  • 最好使用具有有效數位簽名的驅動程式。

類型:IResultObject[]
別名:BootImagePackages
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DriverPackage

指定驅動程式套件物件的數位。 若要取得此物件,請使用 Get-CMDriverPackage Cmdlet。

使用此參數將匯入的驅動程式新增至指定的驅動程式套件。

類型:IResultObject[]
別名:DriverPackages
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-EnableAndAllowInstall

啟用驅動程式,並允許用戶端在 自動套用驅動程式 工作順序步驟期間安裝它。

新增至驅動程式套件的驅動程式不會受到影響。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ImportDuplicateDriverOption

指定 Configuration Manager 如何管理重複的設備驅動器。

  • AppendCategory:匯入驅動程式並將新的類別附加至現有的類別 - KeepExistingCategory:匯入驅動程式並保留現有的類別
  • NotImport:不要匯入驅動程式
  • OverwriteCategory:匯入驅動程式並覆寫現有的類別
類型:ImportDuplicateDriverOption
接受的值:NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ImportFolder

新增此參數以匯入目標資料夾中的所有設備驅動器。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Path

指定要匯入的驅動程式檔案路徑。

類型:String
別名:FileName, FilePath, ImportFilePath, Location, UncFileLocation
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SupportedPlatform

指定設備驅動器適用且可執行的支持平台物件。 若要取得此物件,請使用 Get-CMSupportedPlatform Cmdlet。

類型:IResultObject[]
別名:SupportedPlatforms
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SupportedPlatformName

指定設備驅動器可以執行的支援平台名稱陣列。 例如,"All Windows 10 (64-bit)"

類型:String[]
別名:SupportedPlatformNames
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UpdateBootImageDistributionPoint

指出 Configuration Manager 是否更新其發佈點上的開機映射,以新增驅動程式。

類型:Boolean
別名:UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-UpdateDriverPackageDistributionPoint

如果您使用 -DriverPackage 參數,請將此參數設定為 $true ,以更新指派發佈點上的驅動程式套件。

類型:Boolean
別名:UpdateDistributionPointsforDriverPackage
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

IResultObject