Import-CMComputerInformation
將計算機資訊匯入 Configuration Manager 資料庫。
語法
Import-CMComputerInformation
[-CollectionId <String[]>]
[-CollectionName <String[]>]
-ComputerName <String>
[-InputObject <IResultObject[]>]
[-MacAddress <String>]
[-MergeIfExist]
[-SMBiosGuid <String>]
[-SourceComputerName <String>]
[-UserAccountMigrationBehavior <MigrationBehavior>]
[-UserName <String[]>]
[-WindowsToGoUniqueKey <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Import-CMComputerInformation
[-CollectionId <String[]>]
[-CollectionName <String[]>]
[-EnableColumnHeading <Boolean>]
-FileName <String>
[-InputObject <IResultObject[]>]
[-VariableName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Import-CMComputerInformation Cmdlet 會將計算機資訊直接匯入 Configuration Manager 資料庫。 若要讓 Configuration Manager 將作業系統部署到未安裝作業系統的新電腦，您必須將新電腦新增至 Configuration Manager。 匯入計算機信息之後，Configuration Manager 可以部署操作系統。
您可以藉由指定媒體訪問控制 (MAC) 位址和電腦名稱，以及集合的名稱來匯入單一計算機。 此 Cmdlet 會將這部電腦新增至指定的集合。
您也可以藉由指定逗號分隔值 .csv 檔案與計算機資訊，以及集合的名稱來匯入數部計算機。 此 Cmdlet 會將電腦新增至指定的集合。
您可以指定參照電腦的名稱。 Configuration Manager 會將使用者資訊和設定從參照電腦移轉至新電腦。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：使用檔案匯入計算機
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -FileName "\\cmshare\Public\CM\ImportComputers.csv" -EnableColumnHeading $True此命令會將 CSV 檔案中指定的電腦匯入 [所有系統] 集合中。 此命令包含 -EnableColumnHeading 參數的$True值。 Cmdlet 會忽略檔案的第一行。
範例 2：匯入單一計算機
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA"此命令會將指定的電腦匯入 [所有系統] 集合中。 命令會指定計算機的名稱、MAC 位址和SMBIOS GUID。
範例 3：使用參照計算機匯入計算機
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA" -SourceComputerName "ResourceComputer01"此命令會將指定的電腦匯入 [所有系統] 集合中。 命令會指定計算機的名稱、MAC 位址和SMBIOS GUID。 命令也包含要與新電腦建立關聯的參照計算機。
參數
-CollectionId
| 類型: | String[] |
| 別名: | CollectionIds |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定 Configuration Manager 裝置集合的名稱。
| 類型: | String[] |
| 別名: | CollectionNames |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ComputerName
指定此 Cmdlet 從中匯入資訊的電腦名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableColumnHeading
| 類型: | Boolean |
| 別名: | EnableColumnHeadings |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FileName
指定包含計算機資訊的 .csv 檔案。 檔案必須包含要匯入之每部計算機的名稱和 MAC 位址。
| 類型: | String |
| 別名: | FilePath, ImportFilePath, Path |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定這個 Cmdlet 的輸入。 您可以使用此參數，也可以使用管線將輸入傳送至此 Cmdlet。
| 類型: | IResultObject[] |
| 別名: | Collection, Collections |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-MacAddress
指定計算機的 MAC 位址，格式 (00：00：00：00：00：00) 。 Windows 預安裝環境 (Windows PE) 必須有指定網路適配器的驅動程式。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MergeIfExist
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SMBiosGuid
指定計算機的系統管理 BIOS (SMBIOS) 的 GUID。
| 類型: | String |
| 別名: | SMBIOSID |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SourceComputerName
指定參照電腦的名稱。 Configuration Manager 會將用戶狀態和設定從參照電腦移轉至新電腦。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserAccountMigrationBehavior
| 類型: | MigrationBehavior |
| 接受的值: | CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserName
| 類型: | String[] |
| 別名: | UserNames |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-VariableName
指定匯入資料行的變數名稱。 當您匯入 .csv 檔案時，您可以指定要匯入的數據行，並將其指派給 Configuration Manager 字段。 變數可讓您將數據行指派給變數。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WindowsToGoUniqueKey
| 類型: | String |
| 別名: | WtgUniqueKey |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
輸出
System.Object