Find-SCComputer

참조

모듈:: VirtualMachineManager

Active Directory를 쿼리하여 컴퓨터를 검색하고 컴퓨터 개체를 반환합니다.

Syntax

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 호스트만.
대역 외 컨트롤러가 있는 운영 체제 미설치 컴퓨터.

참고: Active Directory 도메인에 있는 호스트 또는 라이브러리 서버와 같은 새 컴퓨터를 VMM에 추가한 다음 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 도메인에 있고 이름이 "host"로 시작하며 VMM을 통해 관리되지 않는 컴퓨터에 대한 Hyper-V 컴퓨터 개체 목록을 반환합니다. 이 명령이 처리되면 $RunAsAccount Find-SCComputer에 자격 증명을 제공합니다.

참고: 도메인 매개 변수와 함께 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 변수에 저장합니다.

세 번째 명령은 컴퓨터 개체에서 심층 검색을 수행하고 물리적 컴퓨터 개체를 $MyComputer 01 변수로 반환합니다.

마지막 명령은 $MyComputer 01 변수에 저장된 컴퓨터 개체의 속성을 표시합니다.

매개 변수

-ADSearchFilter

검색을 위한 Active Directory 쿼리를 정의합니다. 이 매개 변수를 사용하여 Active Directory 도메인 정보 및 검색 필터가 포함된 쿼리를 지정합니다.

예제 형식: -ADSearchFilter``"(&(sAMAccountType=805306369)(name=katarina*)(objectCategory=computer)(objectClass =computer)(operatingSystem=Windows\20Server*))"

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

-All

이 cmdlet은 부모 개체와 독립적으로 모든 하위 개체를 가져옵니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 모듈을 만들 수도 있습니다.

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

-BMCCustomConfigurationProvider

BMC(베이스보드 관리 컨트롤러)에 대한 구성 공급자 개체를 지정하거나 업데이트합니다. 구성 공급자는 VMM PowerShell 명령을 베이스보드 관리 컨트롤러 유형과 관련된 API 호출로 변환하는 VMM에 대한 플러그 인입니다. 이 매개 변수는 Custom BMCProtocol과 함께 사용해야 합니다.

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

-BMCPort

특정 물리적 컴퓨터에 대한 대역 외 베이스보드 관리 컨트롤러(BMC) 포트를 지정하거나 업데이트합니다. BMC 포트를 서비스 프로세서 포트라고도 합니다. 기본 포트의 예는 IPMI의 경우 623, WS-Man을 통해 SMASH의 경우 443입니다.

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

-BMCProtocol

VMM이 BMC(대역 외 베이스보드 관리 컨트롤러)와 통신하는 데 사용하는 프로토콜을 지정하거나 업데이트합니다. 유효한 값은 다음과 같습니다.

IPMI
스 매쉬
사용자 지정

BMC(서비스 프로세서 또는 관리 컨트롤러라고도 함)는 하드웨어와 시스템 관리 소프트웨어 간의 인터페이스 역할을 하는 서버의 마더보드에 있는 특수 컨트롤러입니다. 물리적 컴퓨터의 마더보드에 BMC가 포함되어 있는 경우 컴퓨터가 전원이 꺼져 있거나 전원이 켜지는지 여부와 운영 체제가 설치되었는지 여부와 관계없이 시스템 하드웨어 및 해당 시스템 하드웨어 상태의 상태에 대한 정보를 사용할 수 있습니다.

예제 형식: -BMCProtocol "Custom"

참고: 사용자 지정 프로토콜을 사용하려면 BMCCustomConfigurationProvider 매개 변수를 사용해야 합니다.

Type:	OutOfBandManagementType
Accepted values:	IPMI, SMASH, Custom
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BMCRunAsAccount

BMC(베이스보드 관리 컨트롤러) 디바이스에서 사용할 실행 계정을 지정합니다.

Type:	RunAsAccount
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

VMM이 네트워크에서 고유하게 식별할 수 있는 컴퓨터 이름을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

FQDN
IPv4 또는 IPv6 주소
NetBIOS 이름

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerNameFilter

cmdlet을 통해 Active Directory에서 검색할 컴퓨터의 이름(전체 또는 일부)을 지정합니다.

예제 형식: -ComputerNameFilter "host"

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

-Credential

자격 증명 개체를 지정하거나 일부 cmdlet의 경우 이 작업을 수행할 수 있는 권한이 있는 계정의 사용자 이름과 암호를 포함하는 실행 계정 개체를 지정합니다. 또는 Restart-SCJob의 경우 다시 시작한 작업을 완료할 수 있는 권한이 있습니다.

PSCredential 개체에 대한 자세한 내용은 을 입력합니다 Get-Help Get-Credential.

실행 계정에 대한 자세한 내용은 .를 입력 Get-Help New-SCRunAsAccount합니다.

Type:	VMMCredential
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DeepDiscovery

지정된 컴퓨터에 심층 검색이 사용됨을 나타냅니다.

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

-DiscoveryID

내부용 - 코드에 사용하지 마십시오.

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

-Domain

Active Directory 도메인의 정규 도메인 이름(FQDN)을 지정합니다.

예제 형식: -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

현재 VMM에서 관리되는 가상 머신 호스트를 제외합니다.

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

-ExcludeVMMLibrary

현재 VMM을 통해 관리되는 라이브러리 서버를 제외합니다.

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

-ExcludeVMs

가상 머신을 제외합니다.

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

-FindHyperVHost

Hyper-V 서버 역할이 사용되는 Windows Server 2008 이상을 실행하는 컴퓨터를 검색합니다.

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

-IPAddressRangeEnd

IP 주소 범위의 마지막 IP 주소를 지정합니다. IPAddressRangeStart 매개 변수와 함께 사용합니다.

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

-IPAddressRangeStart

IP 주소 범위의 첫 번째 IP 주소를 지정합니다. IPAddressRangeEnd 매개 변수와 함께 사용합니다.

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

-JobVariable

작업 진행률을 추적하여 이 매개 변수로 이름이 지정된 변수에 보관하도록 지정합니다.

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

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

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

-SMBiosGuid

VMM에서 해당 물리적 컴퓨터의 레코드와 연결된 물리적 컴퓨터에 대한 시스템 관리 BIOS 전역 고유 식별자(SMBIOS GUID)를 지정합니다.

SMBIOS는 사용자 또는 애플리케이션이 시스템, 제조업체 또는 시스템 BIOS 버전의 이름과 같은 이 컴퓨터의 하드웨어에 대한 정보를 저장하고 검색할 수 있도록 하는 데이터 구조 및 액세스 방법을 정의합니다. Windows 운영 체제는 시스템 시작 시 SMBIOS 데이터를 검색하고 해당 데이터를 프로그램에서 사용할 수 있도록 합니다.

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

-Subnet

CIDR(클래스리스 Inter-Domain 라우팅) 표기법에서 IP 서브넷(IPv4 또는 IPv6)을 지정합니다.

IPv4 서브넷의 예제 형식: 192.168.0.1/24

IPv6 서브넷의 예제 형식: FD4A:29CD:184F:3A2C::/64

참고: IP 서브넷은 호스트 그룹 또는 자식 호스트 그룹의 다른 서브넷과 겹칠 수 없습니다.

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

-VMMServer

VMM 서버 개체를 지정합니다.

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

출력

Computer

이 cmdlet은 Computer 개체를 반환합니다.

Get-SCRunAsAccount

Find-SCComputer

Syntax

Description

예제

예제 1: 지정된 조건을 충족하는 특정 도메인의 컴퓨터 검색

예제 2: 이름으로 특정 컴퓨터를 검색하고 Active Directory에서 해당 속성의 유효성을 검사합니다.

예제 3: VMM 라이브러리 서버가 아닌 지정된 도메인의 모든 컴퓨터 검색

예제 4: Active Directory 쿼리를 사용하여 지정된 도메인에서 관리되지 않는 모든 컴퓨터 찾기

예제 5: 특정 네트워크 범위 내에 있는 대역 외 컨트롤러가 있는 운영 체제 미설치 컴퓨터 찾기

예제 6: 운영 체제 미설치 컴퓨터 지원으로 물리적 컴퓨터에서 심층 검색 수행

매개 변수

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

출력

관련 링크

추가 리소스