Import-CMComputerInformation
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. Nachdem Sie die Computerinformationen importiert haben, kann Configuration Manager ein Betriebssystem bereitstellen.
Sie können einen einzelnen Computer importieren, indem Sie die MAC-Adresse (Media Access Control) und den Computernamen zusammen mit dem Namen einer Sammlung angeben. Dieses Cmdlet fügt diesen Computer der angegebenen Sammlung hinzu.
Sie können auch mehrere Computer importieren, indem Sie eine Durch Trennzeichen getrennte Werte .csv Datei mit Computerinformationen zusammen mit dem Namen einer Sammlung angeben. Dieses Cmdlet fügt die Computer der angegebenen Auflistung hinzu.
Sie können den Namen eines Referenzcomputers angeben. Configuration Manager migriert Benutzerinformationen und Einstellungen vom Referenzcomputer zum neuen Computer.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . 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 $TrueDieser Befehl importiert die in der CSV-Datei angegebenen Computer in die Sammlung Alle Systeme. 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"Dieser Befehl importiert einen angegebenen Computer in die Sammlung Alle Systeme. 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"Dieser Befehl importiert einen angegebenen Computer in die Sammlung Alle Systeme. 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
| Typ: | String[] |
| Aliase: | CollectionIds |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionName
Gibt einen Namen einer Configuration Manager-Gerätesammlung an.
| Typ: | String[] |
| Aliase: | CollectionNames |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ComputerName
Gibt den Namen eines Computers an, von dem dieses Cmdlet Informationen importiert.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableColumnHeading
| Typ: | Boolean |
| Aliase: | EnableColumnHeadings |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String |
| Aliase: | FilePath, ImportFilePath, Path |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe an dieses Cmdlet weiterleiten.
| Typ: | IResultObject[] |
| Aliase: | Collection, Collections |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MergeIfExist
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SMBiosGuid
Gibt eine GUID für das Systemverwaltungs-BIOS (SMBIOS) eines Computers an.
| Typ: | String |
| Aliase: | SMBIOSID |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SourceComputerName
Gibt einen Namen eines Referenzcomputers an. Configuration Manager migriert den Benutzerzustand und die Einstellungen vom Referenzcomputer zum neuen Computer.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserAccountMigrationBehavior
| Typ: | MigrationBehavior |
| Zulässige Werte: | CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserName
| Typ: | String[] |
| Aliase: | UserNames |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WindowsToGoUniqueKey
| Typ: | String |
| Aliase: | WtgUniqueKey |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Ausgaben
System.Object