Share via

Import-CMComputerInformation

  • Referência
Módulo:
ConfigurationManager

Importa informações do computador para um banco de dados do 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

O cmdlet Import-CMComputerInformation importa informações do computador diretamente para um banco de dados do Configuration Manager. Para o Configuration Manager implantar um sistema operacional em um novo computador sem sistema operacional instalado, você deve adicionar o novo computador ao Configuration Manager. Depois de importar as informações do computador, o Configuration Manager pode implantar um sistema operacional.

Você pode importar um único computador especificando o endereço mac e o nome do computador do Controle de Acesso para Mídia, juntamente com o nome de uma coleção. Este cmdlet adiciona esse computador à coleção especificada.

Você também pode importar vários computadores especificando um arquivo Valores Separados por Vírgula .csv com informações do computador, juntamente com o nome de uma coleção. Este cmdlet adiciona os computadores à coleção especificada.

Você pode especificar o nome de um computador de referência. O Configuration Manager migra informações e configurações do usuário do computador de referência para o novo computador.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Importar computadores usando um arquivo

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

Esse comando importa os computadores especificados no arquivo CSV para a coleção All Systems. Este comando inclui um valor de $True para o parâmetro -EnableColumnHeading. O cmdlet ignora a primeira linha do arquivo.

Exemplo 2: Importar um único computador

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

Esse comando importa um computador especificado para a coleção All Systems. O comando especifica o nome, o endereço MAC e o GUID SMBIOS para um computador.

Exemplo 3: Importar um computador usando um computador de referência

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

Esse comando importa um computador especificado para a coleção All Systems. O comando especifica o nome, o endereço MAC e o GUID SMBIOS para um computador. O comando também inclui um computador de referência para associar ao novo computador.

Parâmetros

-CollectionId

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

-CollectionName

Especifica um nome de uma coleção de dispositivos do Configuration Manager.

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

-ComputerName

Especifica o nome de um computador de onde esse cmdlet importa informações.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com 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 um arquivo .csv que contém informações do computador. O arquivo deve conter o nome e o endereço MAC de cada computador a ser importado.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-InputObject

Especifica a entrada para este cmdlet. Você pode usar esse parâmetro ou pode canalizar a entrada para este cmdlet.

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

-MacAddress

Especifica um endereço MAC para um computador no formato (00:00:00:00:00:00:00). O Windows ambiente de pré-instalação (Windows PE) deve ter um driver para o adaptador de rede 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 um GUID para o BIOS de gerenciamento do sistema (SMBIOS) de um computador.

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

-SourceComputerName

Especifica um nome de um computador de referência. O Configuration Manager migra o estado do usuário e as configurações do computador de referência para o novo computador.

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 um nome de variável para uma coluna importada. Ao importar um arquivo .csv, especifique as colunas para importar e atribuí-las a um campo Gerenciador de Configurações. Uma variável permite atribuir uma coluna a uma variável.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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[]

Saídas

System.Object