Import-CMComputerInformation
將電腦資訊匯入至 Configuration Manager 資料庫。
Syntax
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
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 檔案中所指定的電腦匯入 [All Systems] 集合。 此命令包含 -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
| Type: | String[] |
| Aliases: | CollectionIds |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
指定 Configuration Manager 裝置集合的名稱。
| Type: | String[] |
| Aliases: | CollectionNames |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
指定此 Cmdlet 從其匯入資訊之電腦的名稱。
| Type: | String |
| 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 |
-EnableColumnHeading
| Type: | Boolean |
| Aliases: | EnableColumnHeadings |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileName
指定包含電腦資訊的 .csv 檔案。 檔案必須包含要匯入之每一部電腦的名稱和 MAC 位址。
| Type: | String |
| Aliases: | FilePath, ImportFilePath, Path |
| 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 |
-InputObject
指定此 Cmdlet 的輸入。 您可以使用此參數，也可以將輸入輸送至此 Cmdlet。
| Type: | IResultObject[] |
| Aliases: | Collection, Collections |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MacAddress
以格式 (00:00:00:00:00:00) 指定電腦的 MAC 位址。 (Windows PE) 的 Windows 安裝環境必須具有指定的網路介面卡的驅動程式。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MergeIfExist
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBiosGuid
指定電腦的系統管理 BIOS (SMBIOS) 的 GUID。
| Type: | String |
| Aliases: | SMBIOSID |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceComputerName
指定參考電腦的名稱。 Configuration Manager 會將使用者狀態和設定從參考電腦遷移至新電腦。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserAccountMigrationBehavior
| Type: | MigrationBehavior |
| Accepted values: | CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
| Type: | String[] |
| Aliases: | UserNames |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VariableName
指定匯入資料行的變數名稱。 當您匯入 .csv 檔時，您會指定要匯入的欄，並將其指派給 [設定管理員] 欄位。 變數可讓您將資料行指派給變數。
| Type: | String |
| 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 |
-WindowsToGoUniqueKey
| Type: | String |
| Aliases: | WtgUniqueKey |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
ConfigurationManagement [ManagementProvider]
輸出
系統.物件