Import-CMComputerInformation
Импорт сведений о компьютере в базу данных Configuration Manager.
Синтаксис
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>]
Описание
Командлет Import-CMComputerInformation импортирует сведения о компьютере непосредственно в базу данных Configuration Manager. Чтобы Configuration Manager развернул операционную систему на новом компьютере без установленной операционной системы, необходимо добавить новый компьютер в Configuration Manager. После импорта сведений о компьютере Configuration Manager может развернуть операционную систему.
Вы можете импортировать один компьютер, указав mac-адрес и имя компьютера, а также имя коллекции. Этот командлет добавляет этот компьютер в указанную коллекцию.
Можно также импортировать несколько компьютеров, указав значения, разделенные запятыми, .csv файл со сведениями о компьютере, а также имя коллекции. Этот командлет добавляет компьютеры в указанную коллекцию.
Можно указать имя компьютера-образца. Configuration Manager переносит сведения о пользователе и параметры с компьютера-образца на новый компьютер.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Импорт компьютеров с помощью файла
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -FileName "\\cmshare\Public\CM\ImportComputers.csv" -EnableColumnHeading $True
Эта команда импортирует компьютеры, указанные в CSV-файле, в коллекцию All Systems. Эта команда содержит значение $True для параметра -EnableColumnHeading . Командлет игнорирует первую строку файла.
Пример 2. Импорт одного компьютера
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA"
Эта команда импортирует указанный компьютер в коллекцию All Systems. Команда задает имя, MAC-адрес и ИДЕНТИФИКАТОР GUID SMBIOS для компьютера.
Пример 3. Импорт компьютера с помощью компьютера-образца
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA" -SourceComputerName "ResourceComputer01"
Эта команда импортирует указанный компьютер в коллекцию All Systems. Команда задает имя, MAC-адрес и ИДЕНТИФИКАТОР GUID SMBIOS для компьютера. Команда также включает компьютер-эталон для связывания с новым компьютером.
Параметры
-CollectionId
Тип: | String[] |
Aliases: | CollectionIds |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-CollectionName
Указывает имя коллекции устройств Configuration Manager.
Тип: | String[] |
Aliases: | CollectionNames |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ComputerName
Указывает имя компьютера, с который этот командлет импортирует сведения.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-EnableColumnHeading
Тип: | Boolean |
Aliases: | EnableColumnHeadings |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FileName
Указывает файл .csv, содержащий сведения о компьютере. Файл должен содержать имя и MAC-адрес каждого импортируемого компьютера.
Тип: | String |
Aliases: | FilePath, ImportFilePath, Path |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Указывает входные данные для этого командлета. Вы можете использовать этот параметр или передать входные данные в этот командлет.
Тип: | IResultObject[] |
Aliases: | Collection, Collections |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-MacAddress
Указывает MAC-адрес для компьютера в формате (00:00:00:00:00:00:00). Среда предустановки Windows (Windows PE) должна иметь драйвер для указанного сетевого адаптера.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MergeIfExist
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SMBiosGuid
Указывает GUID для BIOS управления системой (SMBIOS) компьютера.
Тип: | String |
Aliases: | SMBIOSID |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SourceComputerName
Указывает имя компьютера-образца. Configuration Manager переносит состояние пользователя и параметры с компьютера-образца на новый компьютер.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UserAccountMigrationBehavior
Тип: | MigrationBehavior |
Допустимые значения: | CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UserName
Тип: | String[] |
Aliases: | UserNames |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VariableName
Указывает имя переменной для импортированного столбца. При импорте файла .csv необходимо указать столбцы для импорта и назначить их полю Configuration Manager. Переменная позволяет назначить столбец переменной.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WindowsToGoUniqueKey
Тип: | String |
Aliases: | WtgUniqueKey |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Выходные данные
System.Object