Import-CMComputerInformation

  • Referenz
Modul:
ConfigurationManager

Importiert Computerinformationen in eine Configuration Manager-Datenbank.

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

Beschreibung

Das Cmdlet "Import-CMComputerInformation" importiert Computerinformationen direkt in eine Configuration Manager-Datenbank. Damit Configuration Manager ein Betriebssystem auf einem neuen Computer ohne installiertes Betriebssystem bereitstellen kann, müssen Sie den neuen Computer zu Configuration Manager hinzufügen. Nach dem Importieren der Computerinformationen kann Configuration Manager ein Betriebssystem bereitstellen.

Sie können einen einzelnen Computer importieren, indem Sie die MAC-Adresse (Media Access Control) und den Computernamen sowie den Namen einer Auflistung angeben. Mit diesem Cmdlet wird dieser Computer der angegebenen Auflistung hinzugefügt.

Sie können auch mehrere Computer importieren, indem Sie eine Datei mit kommagetrennten Werten .csv mit Computerinformationen sowie den Namen einer Auflistung angeben. Mit diesem Cmdlet werden die Computer zur angegebenen Auflistung hinzugefügt.

Sie können den Namen eines Referenzcomputers angeben. Configuration Manager migriert Benutzerinformationen und -einstellungen vom Referenzcomputer auf den neuen Computer.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Importieren von Computern mithilfe einer Datei

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

Mit diesem Befehl werden die in der CSV-Datei angegebenen Computer in die Sammlung "Alle Systeme" importiert. Dieser Befehl enthält den Wert $True für den Parameter "-EnableColumnHeading". Das Cmdlet ignoriert die erste Zeile der Datei.

Beispiel 2: Importieren eines einzelnen Computers

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

Mit diesem Befehl wird ein angegebener Computer in die Sammlung "Alle Systeme" importiert. Der Befehl gibt den Namen, die MAC-Adresse und die SMBIOS-GUID für einen Computer an.

Beispiel 3: Importieren eines Computers mithilfe eines Referenzcomputers

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

Mit diesem Befehl wird ein angegebener Computer in die Sammlung "Alle Systeme" importiert. Der Befehl gibt den Namen, die MAC-Adresse und die SMBIOS-GUID für einen Computer an. Der Befehl enthält auch einen Referenzcomputer, der dem neuen Computer zugeordnet werden soll.

Parameter

-CollectionId

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

-CollectionName

Gibt einen Namen einer Configuration Manager-Gerätesammlung an.

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

-ComputerName

Gibt den Namen eines Computers an, von dem dieses Cmdlet Informationen importiert.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

Gibt eine .csv Datei an, die Computerinformationen enthält. Die Datei muss den Namen und die MAC-Adresse jedes zu importierenden Computers enthalten.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-InputObject

Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe an dieses Cmdlet weiterleiten.

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

-MacAddress

Gibt eine MAC-Adresse für einen Computer im Format an (00:00:00:00:00:00:00). Die Windows Preinstallation Environment (Windows PE) muss über einen Treiber für den angegebenen Netzwerkadapter verfügen.

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

Gibt eine GUID für das Systemverwaltungs-BIOS (SMBIOS) eines Computers an.

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

-SourceComputerName

Gibt den Namen eines Referenzcomputers an. Configuration Manager migriert den Benutzerstatus und die Einstellungen vom Referenzcomputer auf den neuen Computer.

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

Gibt einen Variablennamen für eine importierte Spalte an. Wenn Sie eine .csv Datei importieren, geben Sie die zu importierenden Spalten an und weisen sie einem Configuration Manager-Feld zu. Mit einer Variablen können Sie einer Variablen eine Spalte zuweisen.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Ausgaben

System.Object