Find-SCComputer
Active Directory를 쿼리하여 컴퓨터를 검색하고 컴퓨터 개체를 반환합니다.
구문
Find-SCComputer
[-VMMServer <ServerConnection>]
[-ComputerNameFilter <String>]
-Domain <String>
-Credential <VMMCredential>
[-ExcludeVMMHost]
[-ExcludeVMMLibrary]
[-ExcludeVMs]
[-FindHyperVHost]
[-DiscoveryID <Guid>]
[-RunAsynchronously]
[-JobVariable <String>]
[<CommonParameters>]
Find-SCComputer
[-VMMServer <ServerConnection>]
[-ComputerName] <String>
[-Credential <VMMCredential>]
[-ExcludeVMMHost]
[-ExcludeVMMLibrary]
[-DiscoveryID <Guid>]
[-RunAsynchronously]
[<CommonParameters>]
Find-SCComputer
[-VMMServer <ServerConnection>]
-Domain <String>
-ADSearchFilter <String>
-Credential <VMMCredential>
[-ExcludeVMMHost]
[-ExcludeVMMLibrary]
[-ExcludeVMs]
[-FindHyperVHost]
[-DiscoveryID <Guid>]
[-RunAsynchronously]
[-JobVariable <String>]
[<CommonParameters>]
Find-SCComputer
[-VMMServer <ServerConnection>]
-IPAddressRangeStart <String>
-IPAddressRangeEnd <String>
-BMCProtocol <OutOfBandManagementType>
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
[-BMCPort <Int32>]
-BMCRunAsAccount <RunAsAccount>
[-All]
[-DiscoveryID <Guid>]
[-RunAsynchronously]
[-JobVariable <String>]
[<CommonParameters>]
Find-SCComputer
[-VMMServer <ServerConnection>]
-Subnet <String>
-BMCProtocol <OutOfBandManagementType>
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
[-BMCPort <Int32>]
-BMCRunAsAccount <RunAsAccount>
[-All]
[-DiscoveryID <Guid>]
[-RunAsynchronously]
[-JobVariable <String>]
[<CommonParameters>]
Find-SCComputer
[-VMMServer <ServerConnection>]
-BMCAddress <String>
-BMCProtocol <OutOfBandManagementType>
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
[-BMCPort <Int32>]
-BMCRunAsAccount <RunAsAccount>
[-SMBiosGuid <Guid>]
[-DeepDiscovery]
[-DiscoveryID <Guid>]
[-RunAsynchronously]
[-JobVariable <String>]
[<CommonParameters>]
Description
Find-SCComputer cmdlet은 Active Directory를 쿼리하여 하나 이상의 컴퓨터를 검색하고 컴퓨터 개체를 반환합니다.
이 cmdlet을 사용하여 지정된 조건에 따라 컴퓨터에 대한 Active Directory를 쿼리하거나 다음을 비롯한 조건 조합을 쿼리할 수 있습니다.
컴퓨터의 FQDN(정규화된 도메인 이름)입니다.
컴퓨터 이름의 전체 또는 일부입니다.
도메인의 이름입니다.
VMM(Virtual Machine Manager)에서 관리하는 호스트를 제외한 모든 컴퓨터.
VMM에서 관리하는 라이브러리 서버를 제외한 모든 컴퓨터
호스트만 Hyper-V.
대역 외 컨트롤러가 있는 운영 체제 미설치 컴퓨터.
참고: VMM에 Active Directory 도메인에 있는 호스트 또는 라이브러리 서버와 같은 새 컴퓨터를 추가한 다음 Discover-Computer cmdlet을 즉시 실행하는 경우 cmdlet은 Active Directory를 검색할 때 새 컴퓨터를 즉시 검색하지 못할 수 있습니다. 새 컴퓨터에 대한 데이터가 Active Directory 도메인 간에 아직 복제되지 않았기 때문에 이 지연이 발생할 수 있습니다. 도메인 관리자인 경우 Active Directory 사이트 및 서비스 콘솔을 사용하여 데이터를 즉시 복제하도록 강제할 수 있습니다.
예제
예제 1: 지정된 조건을 충족하는 특정 도메인의 컴퓨터 검색
PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ComputerNameFilter "host" -Domain "Contoso.com" -FindHyperVHosts -ExcludeVMMHost -RunAsAccount $RunAsAccount
첫 번째 명령은 호스트 컴퓨터 계정 01이라는 실행 계정 개체를 가져오고 개체를 $RunAsAccount 변수에 저장합니다.
두 번째 명령은 Active Directory를 쿼리하고 Contoso.com 도메인에 있고 이름이 "호스트"로 시작하며 VMM에서 관리되지 않는 컴퓨터의 Hyper-V 컴퓨터 개체 목록을 반환합니다.
이 명령이 처리되면 $RunAsAccount Find-SCComputer
참고: Domain 매개 변수와 함께 Find-SCComputer 사용하는 경우 정규화된 도메인 이름을 지정해야 합니다.
예제 2: 이름으로 특정 컴퓨터를 검색하고 Active Directory에서 해당 속성의 유효성을 검사합니다.
PS C:\> Find-SCComputer -ComputerName "VMHost01.Contoso.com"
이 명령은 VMHost01이라는 컴퓨터의 FQDN(정규화된 도메인 이름)을 사용하여 Active Directory에서 이 컴퓨터를 찾고, 컴퓨터 개체를 반환하고, 사용자에게 컴퓨터 개체 속성을 표시합니다.
예제 3: VMM 라이브러리 서버가 아닌 지정된 도메인의 모든 컴퓨터 검색
PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ComputerNameFilter "vmm" -Domain "Contoso.com" -ExcludeVMMLibrary -RunAsAccount $RunAsAccount
첫 번째 명령은 호스트 컴퓨터 계정 01이라는 실행 계정 개체를 가져오고 개체를 $RunAsAccount 변수에 저장합니다.
두 번째 명령은 VMM 라이브러리 서버를 제외한 컴퓨터 이름에 "vmm"을 포함하는 Contoso.com 도메인의 모든 컴퓨터에 대해 Active Directory를 쿼리합니다.
이 명령이 처리되면 $RunAsAccount Find-SCComputer
예제 4: Active Directory 쿼리를 사용하여 지정된 도메인에서 관리되지 않는 모든 컴퓨터 찾기
PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ADSearchFilter "(&(sAMAccountType=805306369)(name=Test0*)(objectCategory=computer)(objectClass=computer)(operatingSystem=Windows\20Server\202008\20R2*))" -Domain "Contoso.com" -ExcludeVMMLibrary -ExcludeVMMHost -RunAsAccount $RunAsAccount
첫 번째 명령은 호스트 컴퓨터 계정 01이라는 실행 계정 개체를 가져오고 개체를 $RunAsAccount 변수에 저장합니다.
두 번째 명령은 쿼리 조건을 충족하는 Contoso.com 도메인의 모든 컴퓨터( Test0으로 시작하지만 VMM 라이브러리 서버 또는 VMM 호스트가 아닌 이름을 가진 Windows Server 2008 R2 컴퓨터)에 대해 Active Directory를 쿼리합니다.
이 명령이 처리되면 $RunAsAccount Find-SCComputer
예제 5: 특정 네트워크 범위 내에 대역 외 컨트롤러가 있는 운영 체제 미설치 컴퓨터 찾기
PS C:\> $BMCRunAsAccount = Get-SCRunAsAccount "BMC Account 01"
PS C:\> Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRunAsAccount -BMCProtocol "IPMI"
첫 번째 명령은 BMC Account 01이라는 실행 계정 개체를 가져오고 개체를 $BMCRunAsAccount 변수에 저장합니다.
두 번째 명령은 지정된 BMCAddress를 사용하여 실제 컴퓨터에 대한 네트워크를 검색합니다.
이 명령이 처리되면 $BMCRunAsAccount Find-SCComputer
예제 6: 운영 체제 미설치 컴퓨터 지원으로 물리적 컴퓨터에서 심층 검색 수행
PS C:\> $BMCRunAsAccount = Get-SCRunAsAccount "BMC Account 01"
PS C:\> $MyComputer01 = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRunAsAccount -BMCProtocol "IPMI"
PS C:\> $MyComputer01 = Find-SCComputer -DeepDiscovery -BMCAddress $MyComputer01.BMCAddress -BMCRunAsAccount $BMCRunAsAccount -BMCProtocol "IPMI" -SMBIOSGUID $MyComputer01.SMBIOSGUID
PS C:\> $MyComputer01
첫 번째 명령은 BMC Account 01이라는 실행 계정 개체를 가져오고 개체를 $BMCRunAsAccount 변수에 저장합니다.
두 번째 명령은 지정된 BMCAddress를 사용하여 실제 컴퓨터에 대한 네트워크를 검색합니다.
이 명령이 처리되면 $BMCRunAsAccount Find-SCComputer
세 번째 명령은 컴퓨터 개체에서 심층 검색을 수행하고 물리적 컴퓨터 개체를 $MyComputer 01 변수로 반환합니다.
마지막 명령은 $MyComputer 01 변수에 저장된 컴퓨터 개체의 속성을 표시합니다.
매개 변수
-ADSearchFilter
검색을 위한 Active Directory 쿼리를 정의합니다. 이 매개 변수를 사용하여 Active Directory 도메인 정보 및 검색 필터를 포함하는 쿼리를 지정합니다.
예제 형식: -ADSearchFilter``"(&(sAMAccountType=805306369)(name=katarina*)(objectCategory=computer)(objectClass =computer)(operatingSystem=Windows\20Server*))"
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-All
이 cmdlet은 부모 개체와 독립적으로 모든 하위 개체를 가져옵니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BMCAddress
특정 물리적 컴퓨터에 대한 대역 외 BMC(베이스보드 관리 컨트롤러) 주소를 지정하거나 업데이트합니다. IP 주소, FQDN(정규화된 도메인 이름) 또는 DNS 접두사(일반적으로 NetBIOS 이름과 동일한 이름)일 수 있습니다.
일반적으로 BMC 주소와 네트워크에 대한 연결은 표준 네트워크 어댑터와 연결된 IP 주소와는 별개입니다. 또는 일부 컴퓨터는 표준 네트워크 어댑터를 사용하여 BMC 및 네트워크 어댑터에 대한 단일 주소를 제공합니다. 그러나 BMC 주소에는 고유한 포트가 있으므로 네트워크에서 고유하게 식별할 수 있습니다.
예제 IPv4 형식: -BMCAddress "10.0.0.21"
예제 Ipv6 형식: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
예제 FQDN 형식: -BMCAddress "Computer01.Contoso.com"
NetBIOS 형식 예제: -BMCAddress "Computer01"
참고: 기본적으로 VMM은 BMC 주소에 IP 주소 또는 FQDN을 사용합니다. 그러나 다른 유형의 주소를 BMC 주소로 지정할 수 있는 PowerShell 모듈을 만들 수도 있습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BMCCustomConfigurationProvider
BMC(베이스보드 관리 컨트롤러)에 대한 구성 공급자 개체를 지정하거나 업데이트합니다. 구성 공급자는 VMM PowerShell 명령을 베이스보드 관리 컨트롤러 유형과 관련된 API 호출로 변환하는 VMM에 대한 플러그 인입니다. 이 매개 변수는 Custom BMCProtocol과 함께 사용해야 합니다.
형식: | ConfigurationProvider |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BMCPort
특정 물리적 컴퓨터에 대한 대역 외 BMC(베이스보드 관리 컨트롤러) 포트를 지정하거나 업데이트합니다. BMC 포트를 서비스 프로세서 포트라고도 합니다. 기본 포트의 예는 IPMI의 경우 623, WS-Man을 통해 SMASH의 경우 443입니다.
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BMCProtocol
VMM이 BMC(대역 외 베이스보드 관리 컨트롤러)와 통신하는 데 사용하는 프로토콜을 지정하거나 업데이트합니다. 유효한 값은 다음과 같습니다.
- IPMI
- 스매시
- 관습
BMC(서비스 프로세서 또는 관리 컨트롤러라고도 함)는 하드웨어와 시스템 관리 소프트웨어 간의 인터페이스 역할을 하는 서버의 마더보드에 있는 특수 컨트롤러입니다. 물리적 컴퓨터의 마더보드에 BMC가 포함된 경우 컴퓨터가 전원이 꺼져 있거나 전원이 켜지는지 여부와 운영 체제가 설치되었는지 여부에 관계없이 시스템 하드웨어 및 해당 시스템 하드웨어 상태의 상태에 대한 정보를 사용할 수 있습니다.
예제 형식: -BMCProtocol "Custom"
참고: 사용자 지정 프로토콜을 사용하려면 BMCCustomConfigurationProvider 매개 변수를 사용해야 합니다.
형식: | OutOfBandManagementType |
허용되는 값: | IPMI, SMASH, Custom |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BMCRunAsAccount
BMC(베이스보드 관리 컨트롤러) 디바이스에 사용할 실행 계정을 지정합니다.
형식: | RunAsAccount |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ComputerName
VMM이 네트워크에서 고유하게 식별할 수 있는 컴퓨터의 이름을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- FQDN
- IPv4 또는 IPv6 주소
- NetBIOS 이름
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ComputerNameFilter
cmdlet이 Active Directory에서 검색하려고 하는 컴퓨터의 일부 또는 전체 이름을 지정합니다.
예제 형식: -ComputerNameFilter "host"
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Credential
자격 증명 개체를 지정하거나 일부 cmdlet의 경우 이 작업을 수행할 수 있는 권한이 있는 계정의 사용자 이름과 암호를 포함하는 실행 계정 개체를 지정합니다. 또는 Restart-SCJob경우 다시 시작한 작업을 완료할 수 있는 권한이 있습니다.
PSCredential 개체에 대한 자세한 내용은 Get-Help Get-Credential
입력합니다.
실행 계정에 대한 자세한 내용은 Get-Help New-SCRunAsAccount
입력합니다.
형식: | VMMCredential |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DeepDiscovery
딥 검색이 지정된 컴퓨터에 사용됨을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DiscoveryID
내부용으로만 사용됩니다(코드에서 사용할 수 없음).
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Domain
Active Directory 도메인의 FQDN(정규화된 도메인 이름)을 지정합니다.
예제 형식: -Domain "Domain01.Corp.Contoso.com"
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ExcludeVMMHost
현재 VMM에서 관리되는 가상 머신 호스트를 제외합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ExcludeVMMLibrary
현재 VMM에서 관리되는 라이브러리 서버를 제외합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ExcludeVMs
가상 머신을 제외합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-FindHyperVHost
Hyper-V 서버 역할이 사용되는 Windows Server 2008 이상을 실행하는 컴퓨터를 검색합니다.
형식: | SwitchParameter |
별칭: | FindHyperVHosts |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-IPAddressRangeEnd
IP 주소 범위의 마지막 IP 주소를 지정합니다. IPAddressRangeStart 매개 변수와 함께 사용합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-IPAddressRangeStart
IP 주소 범위의 첫 번째 IP 주소를 지정합니다. IPAddressRangeEnd 매개 변수와 함께 사용합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobVariable
작업 진행률이 추적되고 이 매개 변수로 명명된 변수에 저장되도록 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RunAsynchronously
컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SMBiosGuid
VMM에서 해당 물리적 컴퓨터의 레코드와 연결된 물리적 컴퓨터에 대한 시스템 관리 BIOS 전역 고유 식별자(SMBIOS GUID)를 지정합니다.
SMBIOS는 사용자 또는 애플리케이션이 시스템, 제조업체 또는 시스템 BIOS 버전과 같은 이 컴퓨터의 하드웨어에 대한 정보를 저장하고 검색할 수 있도록 하는 데이터 구조 및 액세스 방법을 정의합니다. Windows 운영 체제는 시스템 시작 시 SMBIOS 데이터를 검색하고 해당 데이터를 프로그램에서 사용할 수 있도록 합니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Subnet
CIDR(클래스리스 Inter-Domain 라우팅) 표기법에서 IP 서브넷(IPv4 또는 IPv6)을 지정합니다.
IPv4 서브넷의 예제 형식: 192.168.0.1/24
IPv6 서브넷의 예제 형식: FD4A:29CD:184F:3A2C::/64
참고: IP 서브넷은 호스트 그룹 또는 자식 호스트 그룹의 다른 서브넷과 겹칠 수 없습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VMMServer
VMM 서버 개체를 지정합니다.
형식: | ServerConnection |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
출력
Computer
이 cmdlet은 Computer 개체를 반환합니다.