Import-CMComputerInformation

リファレンス

モジュール:: ConfigurationManager

コンピューター情報を 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 はオペレーティングシステムを展開できます。

1 つのコンピューターをインポートするには、メディアアクセス制御 (MAC) アドレスとコンピューター名とコレクションの名前を指定します。このコマンドレットは、このコンピューターを指定したコレクションに追加します。

複数のコンピューターをインポートするには、コレクションの名前と共に.csvファイルにコンマ区切り値を指定します。このコマンドレットは、指定したコレクションにコンピューターを追加します。

参照コンピューターの名前を指定できます。 Configuration Manager は、参照コンピューターから新しいコンピューターにユーザー情報と設定を移行します。

注意

Configuration Manager サイトドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。詳細については、「Getting started」を参照してください。

例

例 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

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

-CollectionName

Configuration Manager デバイスコレクションの名前を指定します。

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

-ComputerName

このコマンドレットが情報をインポートするコンピューターの名前を指定します。

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

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

コンピューター情報を.csvファイルを指定します。ファイルには、インポートする各コンピューターの名前と MAC アドレスが含まれている必要があります。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-InputObject

このコマンドレットへの入力を指定します。このパラメーターを使用するか、入力をこのコマンドレットにパイプ処理できます。

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

-MacAddress

形式 (00:00:00:00:00:00) のコンピューターの MAC アドレスを指定します。 [Windowsインストール環境 (WINDOWS PE) には、指定したネットワークアダプターのドライバーが必要です。

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

コンピューターのシステム管理 BIOS (SMBIOS) の GUID を指定します。

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

-SourceComputerName

参照コンピューターの名前を指定します。 Configuration Manager は、ユーザーの状態と設定を参照コンピューターから新しいコンピューターに移行します。

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

インポートされた列の変数名を指定します。ファイルをインポートする.csv、インポートする列を指定し、Configuration Manager フィールドに割り当てる必要があります。変数を使用すると、変数に列を割り当てできます。

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

-WhatIf

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

出力

System.Object

Get-CMComputerAssociation