Find-SCComputer

構文

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>]

説明

Find-SCComputer コマンドレットは、Active Directory のクエリを実行して 1 つ以上のコンピューターを検索し、コンピューター オブジェクトを返します。

このコマンドレットを使用して、Active Directory にクエリを行い、指定した条件で、または以下の条件を組み合わせて、コンピュータを検出することができます。

• コンピューターの完全修飾ドメイン名 (FQDN)。

• コンピューター名のすべてまたは一部。

• ドメインの名前。

• Virtual Machine Manager (VMM) によって管理されるホストを除くすべてのコンピューター。

• VMM によって管理されるライブラリ サーバーを除くすべてのコンピューター。

• Hyper-V ホストのみ。

• 帯域外コントローラーがあるベアメタル コンピューター。

注: Active Directory ドメインにある新しいコンピューター (ホストサーバーやライブラリ サーバーなど) を VMM に追加し、直ちに Discover-Computer コマンドレットを実行すると、コマンドレットが 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変数にオブジェクトを格納します。

2 番目のコマンドは、Active Directory にクエリを行って、Contoso.com ドメイン内に存在する、Virtual Machine Manager が管理していない、名前の先頭に "host" の文字を持つコンピュータを検索し、その 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変数にオブジェクトを格納します。

2 番目のコマンドは、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変数にオブジェクトを格納します。

2 番目のコマンドは、クエリ条件を満たす 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 アカウント 01 という名前の実行アカウント オブジェクトを取得し、$BMCRunAsAccount変数にオブジェクトを格納します。

2 番目のコマンドは、指定された 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 アカウント 01 という名前の実行アカウント オブジェクトを取得し、$BMCRunAsAccount変数にオブジェクトを格納します。

2 番目のコマンドは、指定された BMCAddress を持つ物理コンピューターのネットワークをスキャンします。 このコマンドが処理されると、$BMCRunAsAccountは Find-SCComputer に資格情報を提供します。

3 番目のコマンドは、コンピューター オブジェクトに対して詳細な検出を実行し、物理マシン オブジェクトを $MyComputer 01 変数に返します。

最後のコマンドは、$MyComputer 01 変数に格納されているコンピューター オブジェクトのプロパティを表示します。

パラメーター

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

出力

Computer

このコマンドレットは Computer オブジェクトを返します。

関連リンク

• Get-SCRunAsAccount