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