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>] 说明
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"此命令将指定的计算机导入 All Systems 集合。 命令指定计算机的名称、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"此命令将指定的计算机导入 All Systems 集合。 命令指定计算机的名称、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
指定格式为 (00：00：00：00：00：00) 的计算机的 MAC 地址。 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