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>]
Description
Import-CMComputerInformation cmdlet은 컴퓨터 정보를 Configuration Manager 데이터베이스로 직접 가져옵니다. Configuration Manager가 운영 체제가 설치되지 않은 새 컴퓨터에 운영 체제를 배포하려면 새 컴퓨터를 Configuration Manager에 추가해야 합니다. 컴퓨터 정보를 가져온 후 Configuration Manager는 운영 체제를 배포할 수 있습니다.
MAC(미디어 액세스 제어) 주소 및 컴퓨터 이름과 컬렉션 이름을 지정하여 단일 컴퓨터를 가져올 수 있습니다. 이 cmdlet은 이 컴퓨터를 지정된 컬렉션에 추가합니다.
컬렉션 이름과 함께 컴퓨터 정보가 포함된 쉼표로 구분된 값 .csv 파일을 지정하여 여러 컴퓨터를 가져올 수도 있습니다. 이 cmdlet은 지정된 컬렉션에 컴퓨터를 추가합니다.
참조 컴퓨터의 이름을 지정할 수 있습니다. Configuration Manager는 참조 컴퓨터에서 새 컴퓨터로 사용자 정보 및 설정을 마이그레이션합니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>
). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 파일을 사용하여 컴퓨터 가져오기
PS XYZ:\>Import-CMComputerInformation -CollectionName "All Systems" -FileName "\\cmshare\Public\CM\ImportComputers.csv" -EnableColumnHeading $True
이 명령은 CSV 파일에 지정된 컴퓨터를 All Systems 컬렉션으로 가져옵니다. 이 명령에는 -EnableColumnHeading 매개 변수에 대한 $True 값이 포함됩니다. cmdlet은 파일의 첫 번째 줄을 무시합니다.
예제 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 주소 및 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[] |
별칭: | CollectionIds |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-CollectionName
Configuration Manager 디바이스 컬렉션의 이름을 지정합니다.
형식: | String[] |
별칭: | CollectionNames |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ComputerName
이 cmdlet에서 정보를 가져오는 컴퓨터의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableColumnHeading
형식: | Boolean |
별칭: | EnableColumnHeadings |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FileName
컴퓨터 정보를 포함하는 .csv 파일을 지정합니다. 파일은 가져올 각 컴퓨터의 이름과 MAC 주소를 포함해야 합니다.
형식: | String |
별칭: | FilePath, ImportFilePath, Path |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-InputObject
이 cmdlet에 대한 입력을 지정합니다. 이 매개 변수를 사용하거나 입력을 이 cmdlet으로 파이프할 수 있습니다.
형식: | IResultObject[] |
별칭: | Collection, Collections |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-MacAddress
컴퓨터의 MAC 주소를 형식(00:00:00:00:00:00:00)으로 지정합니다. Windows PE(Windows 사전 설치 환경)에는 지정된 네트워크 어댑터에 대한 드라이버가 있어야 합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-MergeIfExist
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SMBiosGuid
컴퓨터의 SMBIOS(시스템 관리 BIOS)에 대한 GUID를 지정합니다.
형식: | String |
별칭: | 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[] |
별칭: | UserNames |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VariableName
가져온 열의 변수 이름을 지정합니다. .csv 파일을 가져올 때 가져올 열을 지정하고 Configuration Manager 필드에 할당합니다. 변수를 사용하면 변수에 열을 할당할 수 있습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WindowsToGoUniqueKey
형식: | String |
별칭: | WtgUniqueKey |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
출력
System.Object