Import-CMComputerInformation
Import-CMComputerInformation
Imports computer information into a Configuration Manager database.
構文
Parameter Set: ImportComputerByUsingFile
Import-CMComputerInformation -CollectionName <String> -FileName <String> [-EnableColumnHeadings <Boolean> ] [-VariableName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ImportSingleComputer
Import-CMComputerInformation -CollectionName <String> -ComputerName <String> -MacAddress <String> [-SmBiosGuid <String> ] [-SourceComputerName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The Import-CMComputerInformation cmdlet imports computer information directly into a Microsoft System Center 2012 Configuration Manager database. For System Center 2012 Configuration Manager to deploy an operating system to a new computer with no installed operating system, you must add the new computer to System Center 2012 Configuration Manager. After you import the computer information, System Center 2012 Configuration Manager can deploy an operating system.
You can import a single computer by specifying the Media Access Control (MAC) address and computer name, along with the name of a collection. This cmdlet adds this computer to the specified collection.
You can also import several computers by specifying a Comma Separated Values .csv file with computer information, along with the name of a collection. This cmdlets adds the computers to the specified collection.
You can specify the name of a reference computer. System Center 2012 Configuration Manager migrates user information and settings from the reference computer to the new computer.
パラメーター
-CollectionName<String>
Specifies a name of a Configuration Manager device collection.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ComputerName<String>
Specifies a name of a computer.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-EnableColumnHeadings<Boolean>
Specifies that the computer information file contains a header row. If you enter a value of $True, the cmdlet ignores the first row of the file.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-FileName<String>
Specifies a .csv file that contains computer information. The file must contain the name and MAC address of each computer to be imported.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-MacAddress<String>
Specifies a MAC address for a computer in the format (00:00:00:00:00:00). The Windows Preinstallation Environment (Windows PE) must have a driver for the specified network adapter.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SmBiosGuid<String>
Specifies a GUID for the system management BIOS (SMBIOS) of a computer.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SourceComputerName<String>
Specifies a name of a reference computer. Configuration Manager migrates user state and settings from the reference computer to the new computer.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-VariableName<String>
Specifies a variable name for an imported column. When you import a .csv file, you specify the columns to import and assign them to a Configuration Manager field. A variable allows you to assign a column to a variable.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
Example 1: Import computers by using a file
This command imports the computers specified in the CVS file into the All Systems collection. This command includes a value of $True for the -EnableColumnHeadings parameter. The cmdlet ignores the first line of the file.
PS C:\> Import-CMComputerInformation -CollectionName "All Systems" -FileName "\\cmshare\Public\CM\ImportComputers.csv" -EnableColumnHeadings $True
Example 2: Import a single computer
This command imports a specified computer into the All Systems collection. The command specifies the name, MAC address, and SMBIOS GUID for a computer.
PS C:\> Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA"
Example 3: Import a computer using a reference computer
This command imports a specified computer into the All Systems collection. The command specifies the name, MAC address, and SMBIOS GUID for a computer. The command also includes a reference computer to associate with the new computer.
PS C:\> Import-CMComputerInformation -CollectionName "All Systems" -ComputerName "Computer08" -MacAddress "5F:DA:FA:FA:FA:FA" -SmBiosGuid "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA" -SourceComputerName "ResourceComputer01"