Import-CMComputerInformation

Módulo:

ConfigurationManager

Importa información del equipo en una base de datos de Configuration Manager.

Sintaxis

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 único equipo especificando la dirección de 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 de usuario y la configuración del equipo de referencia al nuevo equipo.

Nota:

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

Ejemplos

Ejemplo 1: Importación de 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 Todos los sistemas. Este comando incluye un valor de $True para el parámetro -EnableColumnHeading . El cmdlet omite la primera línea del archivo.

Ejemplo 2: Importación de un único 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 Todos los sistemas. El comando especifica el nombre, la dirección MAC y el GUID de SMBIOS para un equipo.

Ejemplo 3: Importación de un equipo mediante 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 Todos los sistemas. El comando especifica el nombre, la dirección MAC y el GUID de SMBIOS para un equipo. El comando también incluye un equipo de referencia que se va a asociar al nuevo equipo.

Parámetros

-CollectionId

Tipo:	String[]
Alias:	CollectionIds
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionName

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

Tipo:	String[]
Alias:	CollectionNames
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ComputerName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EnableColumnHeading

Tipo:	Boolean
Alias:	EnableColumnHeadings
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Alias:	FilePath, ImportFilePath, Path
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

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

Tipo:	IResultObject[]
Alias:	Collection, Collections
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-MacAddress

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MergeIfExist

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SMBiosGuid

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

Tipo:	String
Alias:	SMBIOSID
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SourceComputerName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserAccountMigrationBehavior

Tipo:	MigrationBehavior
Valores aceptados:	CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserName

Tipo:	String[]
Alias:	UserNames
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VariableName

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WindowsToGoUniqueKey

Tipo:	String
Alias:	WtgUniqueKey
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Salidas

System.Object

Vínculos relacionados

• Get-CMComputerAssociation