Import-CMDriver
將裝置驅動程式匯入驅動程式目錄。
Syntax
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
CMDriver Cmdlet 會將一或多個裝置驅動程式匯入 Configuration Manager 的驅動程式目錄中。 當您將裝置驅動程式匯入至目錄時,您可以將裝置驅動程式新增至驅動程式套件或啟動影像套件。
在裝置驅動程式的匯入程式中,Configuration Manager 會讀取與裝置相關聯的下列資訊:
- 提供者
- 類別
- 版本
- 簽章
- 支援的硬體
- 支援的平臺
依預設,驅動程式會以它所支援的第一個硬體裝置命名。 若要重新命名裝置驅動程式,請使用CMDriver Cmdlet 的 -NewName參數。 支援的平臺清單是以驅動程式 INF 檔中的資訊為基礎。 因為此資訊的準確性可能不同,所以在您將其匯入驅動程式目錄之後,請手動驗證裝置驅動程式是否受支援。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:匯入路徑中的所有裝置驅動程式
此命令會匯入位於網路路徑中的所有裝置驅動程式 \\Server1\Driver
。
Import-CMDriver -Path "\\Server1\Driver" -ImportFolder
範例2:依名稱匯入裝置驅動程式
這個命令會從網路路徑匯入名為 driver 的驅動程式 。 \\Server1\Driver
Import-CMDriver -Path "\\Server1\Driver\driver.inf"
參數
-AdministrativeCategory
指定 category 物件的陣列。 若要取得此物件,請使用 CMCategory Cmdlet。
將裝置驅動程式指派給類別,以供篩選的目的,例如桌面或筆記本。
Type: | IResultObject[] |
Aliases: | AdministrativeCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AdministrativeCategoryName
您可以使用此參數只指定類別的名稱,而不是使用 AdministrativeCategory 參數來取得及指定類別的物件。 您也可以使用類別名稱的陣列。
Type: | String[] |
Aliases: | AdministrativeCategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BootImagePackage
指定啟動 image 物件的陣列。 若要取得此物件,請使用 CMBootImage Cmdlet。
使用此參數可將匯入的驅動程式新增至指定的啟動映射。
僅新增 Windows PE (WinPE) 的驅動程式需要啟動:
請確定您新增至啟動映射的驅動程式符合啟動映射的架構。
WinPE 已包含許多內置的驅動程式。 僅新增 WinPE 中未包含的網路和儲存驅動程式。
除非 WinPE 中有其他驅動程式的需求,否則只會將網路和儲存驅動程式新增至啟動映射。
最好使用具有有效數位簽章的驅動程式。
Type: | IResultObject[] |
Aliases: | BootImagePackages |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriverPackage
指定驅動程式套件物件的陣列。 若要取得此物件,請使用 CMDriverPackage Cmdlet。
使用此參數可將匯入的驅動程式新增至指定的驅動程式套件。
Type: | IResultObject[] |
Aliases: | DriverPackages |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAndAllowInstall
啟用驅動程式並允許用戶端在 自動套用驅動程式 任務順序步驟中安裝它。
新增至驅動程式套件的驅動程式不會受到影響。
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImportDuplicateDriverOption
指定 Configuration Manager 管理重複裝置驅動程式的方式。
AppendCategory
:匯入驅動程式並將新類別新增至現有類別- KeepExistingCategory
:匯入驅動程式並保留現有類別NotImport
:不匯入驅動程式OverwriteCategory
:匯入驅動程式並覆寫現有類別
Type: | ImportDuplicateDriverOption |
Accepted values: | NotImport, AppendCategory, KeepExistingCategory, OverwriteCategory |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImportFolder
新增此參數可匯入目的檔案夾中的所有裝置驅動程式。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
指定要匯入之驅動程式檔案的路徑。
Type: | String |
Aliases: | FileName, FilePath, ImportFilePath, Location, UncFileLocation |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SupportedPlatform
指定裝置驅動程式適用且可以執行的支援平臺物件。 若要取得此物件,請使用 CMSupportedPlatform Cmdlet。
Type: | IResultObject[] |
Aliases: | SupportedPlatforms |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SupportedPlatformName
指定裝置磁碟機可執行檔支援平臺名稱陣列。 例如,"All Windows 10 (64-bit)"
。
Type: | String[] |
Aliases: | SupportedPlatformNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateBootImageDistributionPoint
會指出 Configuration Manager 是否在其發佈點上更新啟動映射,以加入新的驅動程式。
Type: | Boolean |
Aliases: | UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateDriverPackageDistributionPoint
如果您使用 -DriverPackage 參數,請將此參數設定為, $true
以在指派的散佈點更新驅動程式套件。
Type: | Boolean |
Aliases: | UpdateDistributionPointsforDriverPackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
無
輸出
IResultObject