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