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 媒体访问控制 (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"

此命令将指定计算机导入到 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

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

指定计算机的 MAC 地址，格式为 (00：00：00：00：00：00) 。预Windows环境 (Windows PE) 必须具有指定网络适配器的驱动程序。

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

指定计算机 SMBIOS (系统管理 BIOS) 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时，应指定要导入的列并将其分配给 Configuration Manager 字段。变量允许您将列分配给变量。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

输出

System.Object

Get-CMComputerAssociation