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 はオペレーティング システムを展開できます。
メディア アクセス制御 (MAC) アドレスとコンピューター名をコレクションの名前と共に指定することで、1 台のコンピューターをインポートできます。 このコマンドレットは、指定したコレクションにこのコンピューターを追加します。
複数のコンピューターをインポートする場合は、コンピューター情報を含むコンマ区切り値 .csv ファイルとコレクションの名前を指定します。 このコマンドレットは、コンピューターを指定したコレクションに追加します。
参照コンピューターの名前を指定できます。 Configuration Manager は、参照コンピューターから新しいコンピューターにユーザー情報と設定を移行します。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ファイルを使用してコンピューターをインポートする
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -FileName "\\cmshare\Public\CM\ImportComputers.csv" -EnableColumnHeading $True
このコマンドは、CSV ファイルで指定されたコンピューターを All Systems コレクションにインポートします。 このコマンドには、 -EnableColumnHeading パラメーターの $True の値が含まれています。 コマンドレットは、ファイルの最初の行を無視します。
例 2: 1 台のコンピューターをインポートする
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 アドレス、および SMBIOS GUID を指定します。
例 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 アドレス、および SMBIOS GUID を指定します。 コマンドには、新しいコンピューターに関連付ける参照コンピューターも含まれています。
パラメーター
-CollectionId
型: | String[] |
Aliases: | CollectionIds |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CollectionName
Configuration Manager デバイス コレクションの名前を指定します。
型: | String[] |
Aliases: | CollectionNames |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ComputerName
このコマンドレットが情報をインポートするコンピューターの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableColumnHeading
型: | Boolean |
Aliases: | EnableColumnHeadings |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-FileName
コンピューター情報を含む .csv ファイルを指定します。 ファイルには、インポートする各コンピューターの名前と MAC アドレスが含まれている必要があります。
型: | String |
Aliases: | FilePath, ImportFilePath, Path |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
このコマンドレットへの入力を指定します。 このパラメーターを使用することも、このコマンドレットに入力をパイプすることもできます。
型: | IResultObject[] |
Aliases: | Collection, Collections |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-MacAddress
コンピューターの MAC アドレスを形式 (00:00:00:00:00:00) で指定します。 Windows プレインストール環境 (Windows PE) には、指定されたネットワーク アダプター用のドライバーが必要です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MergeIfExist
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SMBiosGuid
コンピューターのシステム管理 BIOS (SMBIOS) の GUID を指定します。
型: | String |
Aliases: | SMBIOSID |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SourceComputerName
参照コンピューターの名前を指定します。 Configuration Manager は、ユーザーの状態と設定を参照コンピューターから新しいコンピューターに移行します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserAccountMigrationBehavior
型: | MigrationBehavior |
指定可能な値: | CaptureAllUserAccountsAndRestoreSpecifiedAccounts, CaptureAndRestoreSpecifiedUserAccounts |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserName
型: | String[] |
Aliases: | UserNames |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VariableName
インポートされた列の変数名を指定します。 .csv ファイルをインポートするときは、インポートする列を指定し、それらを Configuration Manager フィールドに割り当てます。 変数を使用すると、変数に列を割り当てることができます。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WindowsToGoUniqueKey
型: | String |
Aliases: | WtgUniqueKey |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
出力
System.Object