Partager via

Import-CMComputerInformation

  • Référence
Module:
ConfigurationManager

Importe les informations de l’ordinateur dans une base de données Configuration Manager.

Syntaxe

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

L’applet de commande Import-CMComputerInformation importe les informations de l’ordinateur directement dans une base de données Configuration Manager. Pour que Configuration Manager déploie un système d’exploitation sur un nouvel ordinateur sans système d’exploitation installé, vous devez ajouter le nouvel ordinateur à Configuration Manager. Après avoir importé les informations de l’ordinateur, Configuration Manager peut déployer un système d’exploitation.

Vous pouvez importer un seul ordinateur en spécifiant l’adresse mac (Media Access Control) et le nom de l’ordinateur, ainsi que le nom d’un regroupement. Cette applet de commande ajoute cet ordinateur au regroupement spécifié.

Vous pouvez également importer plusieurs ordinateurs en spécifiant un fichier Valeurs séparées par des virgules .csv avec des informations sur l’ordinateur, ainsi que le nom d’un regroupement. Cette applet de commande ajoute les ordinateurs au regroupement spécifié.

Vous pouvez spécifier le nom d’un ordinateur de référence. Configuration Manager migre les informations et les paramètres utilisateur de l’ordinateur de référence vers le nouvel ordinateur.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Importer des ordinateurs à l’aide d’un fichier

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

Cette commande importe les ordinateurs spécifiés dans le fichier CSV dans le regroupement Tous les systèmes. Cette commande inclut la valeur $True pour le paramètre -EnableColumnHeading . L’applet de commande ignore la première ligne du fichier.

Exemple 2 : Importer un seul ordinateur

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

Cette commande importe un ordinateur spécifié dans le regroupement Tous les systèmes. La commande spécifie le nom, l’adresse MAC et le GUID SMBIOS d’un ordinateur.

Exemple 3 : Importer un ordinateur à l’aide d’un ordinateur de référence

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

Cette commande importe un ordinateur spécifié dans le regroupement Tous les systèmes. La commande spécifie le nom, l’adresse MAC et le GUID SMBIOS d’un ordinateur. La commande inclut également un ordinateur de référence à associer au nouvel ordinateur.

Paramètres

-CollectionId

Type:String[]
Alias:CollectionIds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifie le nom d’un regroupement d’appareils Configuration Manager.

Type:String[]
Alias:CollectionNames
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ComputerName

Spécifie le nom d’un ordinateur à partir duquel cette applet de commande importe les informations.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableColumnHeading

Type:Boolean
Alias:EnableColumnHeadings
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FileName

Spécifie un fichier .csv qui contient des informations sur l’ordinateur. Le fichier doit contenir le nom et l’adresse MAC de chaque ordinateur à importer.

Type:String
Alias:FilePath, ImportFilePath, Path
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie l’entrée de cette applet de commande. Vous pouvez utiliser ce paramètre ou diriger l’entrée vers cette applet de commande.

Type:IResultObject[]
Alias:Collection, Collections
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MacAddress

Spécifie une adresse MAC pour un ordinateur au format (00:00:00:00:00:00). L’environnement de préinstallation Windows (Windows PE) doit avoir un pilote pour la carte réseau spécifiée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MergeIfExist

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SMBiosGuid

Spécifie un GUID pour le BIOS de gestion système (SMBIOS) d’un ordinateur.

Type:String
Alias:SMBIOSID
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SourceComputerName

Spécifie le nom d’un ordinateur de référence. Configuration Manager migre l’état utilisateur et les paramètres de l’ordinateur de référence vers le nouvel ordinateur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserAccountMigrationBehavior

Type:MigrationBehavior
Valeurs acceptées:CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserName

Type:String[]
Alias:UserNames
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VariableName

Spécifie un nom de variable pour une colonne importée. Lorsque vous importez un fichier .csv, vous spécifiez les colonnes à importer et vous les affectez à un champ Configuration Manager. Une variable vous permet d’affecter une colonne à une variable.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WindowsToGoUniqueKey

Type:String
Alias:WtgUniqueKey
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Sorties

System.Object