Compartilhar via

Import-CMComputerInformation

  • Referência
Módulo:
ConfigurationManager

Importa informações do computador para uma base de dados do Configuration Manager.

Sintaxe

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 uma base de dados do Configuration Manager. Para que o Configuration Manager implemente um sistema operativo num novo computador sem sistema operativo instalado, tem de adicionar o novo computador ao Configuration Manager. Depois de importar as informações do computador, o Configuration Manager pode implementar um sistema operativo.

Pode importar um único computador ao especificar o endereço e o nome do computador do Controlo de Acesso a Multimédia (MAC), juntamente com o nome de uma coleção. Este cmdlet adiciona este computador à coleção especificada.

Também pode importar vários computadores ao especificar um ficheiro valores separados por vírgulas .csv com informações do computador, juntamente com o nome de uma coleção. Este cmdlet adiciona os computadores à coleção especificada.

Pode especificar o nome de um computador de referência. O Configuration Manager migra as informações e definições do utilizador do computador de referência para o novo computador.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: importar computadores com um ficheiro

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

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

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"

Este comando importa um computador especificado para a coleção Todos os Sistemas. O comando especifica o nome, o endereço MAC e o GUID SMBIOS de um computador.

Exemplo 3: importar um computador com 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"

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

Parâmetros

-CollectionId

Tipo:String[]
Aliases:CollectionIds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

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

Tipo:String[]
Aliases:CollectionNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputerName

Especifica o nome de um computador do qual este cmdlet importa informações.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableColumnHeading

Tipo:Boolean
Aliases:EnableColumnHeadings
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileName

Especifica um ficheiro de .csv que contém informações do computador. O ficheiro tem de conter o nome e o endereço MAC de cada computador a importar.

Tipo:String
Aliases:FilePath, ImportFilePath, Path
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica a entrada para este cmdlet. Pode utilizar este parâmetro ou encaminhar a entrada para este cmdlet.

Tipo:IResultObject[]
Aliases:Collection, Collections
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MacAddress

Especifica um endereço MAC para um computador no formato (00:00:00:00:00:00:00). O Ambiente de Pré-instalação do Windows (Windows PE) tem de ter um controlador para a placa de rede especificada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MergeIfExist

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SMBiosGuid

Especifica um GUID para o BIOS de gestão do sistema (SMBIOS) de um computador.

Tipo:String
Aliases:SMBIOSID
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceComputerName

Especifica um nome de um computador de referência. O Configuration Manager migra o estado e as definições do utilizador do computador de referência para o novo computador.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserAccountMigrationBehavior

Tipo:MigrationBehavior
Valores aceitos:CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserName

Tipo:String[]
Aliases:UserNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VariableName

Especifica um nome de variável para uma coluna importada. Quando importa um ficheiro .csv, especifica as colunas a importar e atribuí-las a um campo do Configuration Manager. Uma variável permite-lhe atribuir uma coluna a uma variável.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WindowsToGoUniqueKey

Tipo:String
Aliases:WtgUniqueKey
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Saídas

System.Object