Import-CMComputerInformation

Referencia

Módulo:: ConfigurationManager

Importa información del equipo en una base de datos de 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

El cmdlet Import-CMComputerInformation importa información del equipo directamente en una base de datos de Configuration Manager. Para que Configuration Manager implemente un sistema operativo en un equipo nuevo sin sistema operativo instalado, debe agregar el nuevo equipo a Configuration Manager. Después de importar la información del equipo, Configuration Manager puede implementar un sistema operativo.

Puede importar un solo equipo especificando la dirección del control de acceso multimedia (MAC) y el nombre del equipo, junto con el nombre de una colección. Este cmdlet agrega este equipo a la colección especificada.

También puede importar varios equipos especificando un archivo de valores separados por comas .csv con información del equipo, junto con el nombre de una colección. Este cmdlet agrega los equipos a la colección especificada.

Puede especificar el nombre de un equipo de referencia. Configuration Manager migra la información y la configuración del usuario desde el equipo de referencia al nuevo equipo.

Nota

Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1: Importar equipos mediante un archivo

PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -FileName "\\cmshare\Public\CM\ImportComputers.csv" -EnableColumnHeading $True

Este comando importa los equipos especificados en el archivo CSV en la colección All Systems. Este comando incluye un valor de $True para el parámetro -EnableColumnHeading. El cmdlet omite la primera línea del archivo.

Ejemplo 2: Importar un solo equipo

PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA"

Este comando importa un equipo especificado en la colección All Systems. El comando especifica el nombre, la dirección MAC y el GUID SMBIOS de un equipo.

Ejemplo 3: Importar un equipo con un equipo de referencia

PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA" -SourceComputerName "ResourceComputer01"

Este comando importa un equipo especificado en la colección All Systems. El comando especifica el nombre, la dirección MAC y el GUID SMBIOS de un equipo. El comando también incluye un equipo de referencia para asociarlo al nuevo equipo.

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

Type:	String[]
Aliases:	CollectionIds
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Especifica un nombre de una colección de dispositivos de Configuration Manager.

Type:	String[]
Aliases:	CollectionNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Especifica el nombre de un equipo desde el que este cmdlet importa información.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con 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

Especifica un archivo .csv que contiene información del equipo. El archivo debe contener el nombre y la dirección MAC de cada equipo que se va a importar.

Type:	String
Aliases:	FilePath, ImportFilePath, Path
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Especifica la entrada de este cmdlet. Puede usar este parámetro o canalizar la entrada a este cmdlet.

Type:	IResultObject[]
Aliases:	Collection, Collections
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MacAddress

Especifica una dirección MAC para un equipo con el formato (00:00:00:00:00:00:00). El Windows de preinstalación (Windows PE) debe tener un controlador para el adaptador de red especificado.

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

Especifica un GUID para el BIOS de administración del sistema (SMBIOS) de un equipo.

Type:	String
Aliases:	SMBIOSID
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SourceComputerName

Especifica un nombre de un equipo de referencia. Configuration Manager migra el estado y la configuración del usuario desde el equipo de referencia al nuevo equipo.

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

Especifica un nombre de variable para una columna importada. Al importar un archivo .csv, se especifican las columnas para importarlas y asignarlas a un campo de Configuration Manager. Una variable permite asignar una columna a una variable.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Salidas

System.Object

Get-CMComputerAssociation