다음을 통해 공유


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 개체를 반환합니다.