Import-CMComputerInformation
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 $TrueEste 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