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