Import-CMComputerInformation

参考

模块:: ConfigurationManager

将计算机信息导入 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

Get-CMComputerAssociation

通过

Import-CMComputerInformation

语法

说明

示例

示例 1：使用文件导入计算机

示例 2：导入单台计算机

示例 3：使用引用计算机导入计算机

参数

-CollectionId

-CollectionName

-ComputerName

-Confirm

-DisableWildcardHandling

-EnableColumnHeading

-FileName

-ForceWildcardHandling

-InputObject

-MacAddress

-MergeIfExist

-SMBiosGuid

-SourceComputerName

-UserAccountMigrationBehavior

-UserName

-VariableName

-WhatIf

-WindowsToGoUniqueKey

输入

输出

反馈

其他资源

通过

Import-CMComputerInformation

语法

说明

示例

示例 1：使用文件导入计算机

示例 2：导入单台计算机

示例 3：使用引用计算机导入计算机

参数

-CollectionId

-CollectionName

-ComputerName

-Confirm

-DisableWildcardHandling

-EnableColumnHeading

-FileName

-ForceWildcardHandling

-InputObject

-MacAddress

-MergeIfExist

-SMBiosGuid

-SourceComputerName

-UserAccountMigrationBehavior

-UserName

-VariableName

-WhatIf

-WindowsToGoUniqueKey

输入

输出

相关链接

反馈

其他资源