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