次の方法で共有


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

説明

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

最初のコマンドは、Host Computer Account 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

最初のコマンドは、Host Computer Account 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

最初のコマンドは、Host Computer Account 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

検出用の 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

このコマンドレットは、親オブジェクトに関係なくすべての下位オブジェクトを取得することを示します。

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 とネットワーク アダプターの 1 つのアドレスを指定します。 ただし、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 へのプラグインです。 このパラメーターは、カスタム 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 経由のスマッシュの場合は 443 です。

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

-BMCProtocol

VMM が帯域外ベースボード管理コントローラー (BMC) との通信に使用するプロトコルを指定または更新します。 有効な値は次のとおりです。

  • IPMI
  • スマッシュ
  • Custom

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

ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 このパラメーターの有効値は、次のとおりです。

  • FQDN
  • IPv4 または IPv6 アドレス
  • NetBIOS 名
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerNameFilter

Active Directory 内でコマンドレットが検出するコンピュータ名の一部またはすべてを指定します。

形式の例: -ComputerNameFilter "host"

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

-Credential

資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、 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

Virtual Machine Manager が現在管理しているライブラリ サーバーを除外します。

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 でその物理コンピューターのレコードに関連付けられている物理コンピューターの System Management 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

クラスレス Inter-Domain ルーティング (CIDR) 表記で 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

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