Find-SCComputer

Reference

Modul:: VirtualMachineManager

Vyhledá počítače dotazováním služby Active Directory a vrátí objekty počítače.

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

Rutina Find-SCComputer vyhledá jeden nebo více počítačů dotazováním služby Active Directory a vrátí objekty počítače.

Tuto rutinu můžete použít k dotazování služby Active Directory na počítače na základě zadaných kritérií nebo kombinace kritérií, včetně:

Plně kvalifikovaný název domény (FQDN) počítače.
Název počítače je celý nebo jeho část.
Název domény.
Všechny počítače kromě hostitelů spravovaných nástrojem Virtual Machine Manager (VMM).
Všechny počítače kromě serverů knihoven spravovaných nástrojem VMM.
Pouze hostitelé Hyper-V.
Holé počítače, které mají vzdálené řadiče.

Poznámka: Pokud přidáte nový počítač, například hostitel nebo server knihovny, umístěný v doméně služby Active Directory do nástroje VMM a pak okamžitě spustíte rutinu Discover-Computer , rutina nemusí při hledání služby Active Directory okamžitě zjistit nový počítač. K tomuto zpoždění může dojít, protože data o novém počítači ještě nebyla replikována v doméně služby Active Directory. Pokud jste správcem domény, můžete pomocí konzoly služby Active Directory Sites and Services vynutit okamžité replikaci dat.

Příklady

Příklad 1: Hledání počítačů v konkrétní doméně, které splňují zadaná kritéria

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ComputerNameFilter "host" -Domain "Contoso.com" -FindHyperVHosts -ExcludeVMMHost -RunAsAccount $RunAsAccount

První příkaz získá objekt účtu Spustit jako s názvem Účet hostitelského počítače 01 a uloží objekt do proměnné $RunAsAccount.

Druhý příkaz dotazuje službu Active Directory a vrátí seznam objektů počítače Hyper-V pro počítače umístěné v Contoso.com doméně, které mají název začínající na "hostitel" a které nejsou spravovány nástrojem VMM. Při zpracování tohoto příkazu $RunAsAccount poskytuje přihlašovací údaje pro Find-SCComputer.

Poznámka: Pokud používáte Find-SCComputer s parametrem Domain , musíte zadat plně kvalifikovaný název domény.

Příklad 2: Vyhledání konkrétního počítače podle názvu a ověření jeho vlastností ve službě Active Directory

PS C:\> Find-SCComputer -ComputerName "VMHost01.Contoso.com"

Tento příkaz používá plně kvalifikovaný název domény (FQDN) počítače s názvem VMHost01 k vyhledání tohoto počítače ve službě Active Directory, vrátí objekt počítače a zobrazí vlastnosti objektu počítače uživateli.

Příklad 3: Vyhledejte všechny počítače v zadané doméně, které nejsou serverem knihovny VMM.

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "Host Computer Account 01"
PS C:\> Find-SCComputer -ComputerNameFilter "vmm" -Domain "Contoso.com" -ExcludeVMMLibrary -RunAsAccount $RunAsAccount

První příkaz získá objekt účtu Spustit jako s názvem Účet hostitelského počítače 01 a uloží objekt do proměnné $RunAsAccount.

Druhý příkaz dotazuje službu Active Directory pro všechny počítače v Contoso.com doméně, která obsahuje "vmm" do názvu počítače s výjimkou serverů knihovny VMM. Při zpracování tohoto příkazu $RunAsAccount poskytuje přihlašovací údaje pro Find-SCComputer.

Příklad 4: Vyhledání všech nespravovaných počítačů v zadané doméně pomocí dotazu služby 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

První příkaz získá objekt účtu Spustit jako s názvem Účet hostitelského počítače 01 a uloží objekt do proměnné $RunAsAccount.

Druhý příkaz dotazuje službu Active Directory pro všechny počítače v Contoso.com doméně, která splňuje kritéria dotazu: jakýkoli počítač s Windows Serverem 2008 R2 s názvem, který začíná test0, ale které nejsou servery knihovny VMM ani hostitelé VMM. Při zpracování tohoto příkazu $RunAsAccount poskytuje přihlašovací údaje pro Find-SCComputer.

Příklad 5: Vyhledání holých počítačů, které mají vzdálené řadiče, které jsou v určitém rozsahu sítě

PS C:\> $BMCRunAsAccount = Get-SCRunAsAccount "BMC Account 01"
PS C:\> Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRunAsAccount -BMCProtocol "IPMI"

První příkaz získá objekt účtu Spustit jako s názvem BMC Account 01 a uloží objekt do proměnné $BMCRunAsAccount.

Druhý příkaz prohledá síť fyzického počítače se zadaným řadičem pro správu základní desky. Při zpracování tohoto příkazu $BMCRunAsAccount poskytuje přihlašovací údaje pro Find-SCComputer.

Příklad 6: Provedení hloubkového zjišťování na fyzickém počítači s podporou holých počítačů

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

První příkaz získá objekt účtu Spustit jako s názvem BMC Account 01 a uloží objekt do proměnné $BMCRunAsAccount.

Třetí příkaz provede hloubkové zjišťování objektu počítače a vrátí objekt fyzického počítače do proměnné $MyComputer 01.

Poslední příkaz zobrazí vlastnosti objektu počítače uloženého v proměnné $MyComputer 01.

Parametry

-ADSearchFilter

Definuje dotaz služby Active Directory pro zjišťování. Tento parametr použijte k určení dotazu, který obsahuje informace o doméně služby Active Directory a filtry hledání.

Příklad formátu: -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

Označuje, že tato rutina získá všechny podřízené objekty nezávislé na nadřazeného objektu.

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

-BMCAddress

Určuje nebo aktualizuje adresu vzdáleného řadiče pro správu základní desky (BMC) pro konkrétní fyzický počítač. Může se jednat o IP adresu, plně kvalifikovaný název domény (plně kvalifikovaný název domény) nebo předponu DNS (což je obvykle stejný název jako název NetBIOS).

Adresa řadiče pro správu základní desky a její připojení k síti jsou obvykle oddělené od IP adresy přidružené ke standardnímu síťovému adaptéru. Případně některé počítače používají standardní síťový adaptér k poskytnutí jedné adresy řadiče pro správu základní desky a síťového adaptéru. Adresa řadiče pro správu základní desky ale má jedinečný port a je tak jedinečně identifikovatelná v síti.

Příklad formátu IPv4: -BMCAddress "10.0.0.21"

Příklad formátu Ipv6: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Příklad formátu plně kvalifikovaného názvu domény: -BMCAddress "Computer01.Contoso.com"

Příklad formátu NetBIOS: -BMCAddress "Computer01"

Poznámka: Ve výchozím nastavení nástroj VMM používá IP adresu nebo plně kvalifikovaný název domény pro adresu řadiče pro správu základní desky. Je ale také možné vytvořit modul PowerShellu, který umožňuje zadat jiné typy adres jako adresu řadiče pro správu základní desky.

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

-BMCCustomConfigurationProvider

Určuje nebo aktualizuje objekt zprostředkovatele konfigurace pro řadič pro správu základní desky (BMC). Zprostředkovatel konfigurace je modul plug-in do nástroje VMM, který překládá příkazy PowerShellu VMM na volání rozhraní API, která jsou specifická pro typ kontroleru správy základní desky. Tento parametr by se měl použít s custom BMCProtocol.

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

-BMCPort

Určuje nebo aktualizuje port řadiče pro vzdálenou správu základní desky (BMC) pro konkrétní fyzický počítač. Port řadiče pro správu základní desky se také označuje jako port procesoru služby. Příklad výchozích portů je 623 pro IPMI a 443 pro SMASH přes WS-Man.

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

-BMCProtocol

Určuje nebo aktualizuje protokol, který nástroj VMM používá ke komunikaci s kontrolerem pro vzdálenou správu základní desky (BMC). Platné hodnoty jsou:

IPMI
ROZBÍT
Vlastní

Řadič pro správu základní desky (označovaný také jako procesor služby nebo řadič pro správu) je specializovaný kontroler na základní desce serveru, který funguje rozhraní mezi hardwarem a softwarem pro správu systému. Pokud základní deska fyzického počítače obsahuje řadič pro správu základní desky, je-li počítač připojený (bez ohledu na to, jestli je vypnutý nebo zapnutý, a zda je nainstalován operační systém), informace o systémovém hardwaru a stavu tohoto systémového stavu hardwaru jsou k dispozici.

Příklad formátu: -BMCProtocol "Custom"

Poznámka: Vlastní protokol vyžaduje, abyste použili parametr BMCCustomConfigurationProvider .

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

-BMCRunAsAccount

Určuje účet Spustit jako, který se má použít se zařízením řadiče pro správu základní desky (BMC).

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

-ComputerName

Určuje název počítače, který nástroj VMM může jedinečně identifikovat ve vaší síti. Tento parametr přijímá tyto hodnoty:

FQDN
Adresa IPv4 nebo IPv6
Název rozhraní NetBIOS

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

-ComputerNameFilter

Určuje částečný nebo úplný název počítače, který se rutina pokusí zjistit ve službě Active Directory.

Příklad formátu: -ComputerNameFilter "host"

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

-Credential

Určuje objekt přihlašovacích údajů nebo u některých rutin objekt účtu Spustit jako, který obsahuje uživatelské jméno a heslo účtu, který má oprávnění k provedení této akce. Nebo v případě restart-SCJob má oprávnění k dokončení restartované úlohy.

Další informace o objektu PSCredential zadejte Get-Help Get-Credential.

Další informace o účtech Spustit jako potřebujete, zadejte Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Označuje, že se pro zadaný počítač používá hluboké zjišťování.

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

-DiscoveryID

Pouze pro interní použití (ne pro použití v kódu).

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

-Domain

Určuje plně kvalifikovaný název domény (FQDN) pro doménu služby Active Directory.

Příklad formátu: -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

Vyloučí hostitele virtuálních počítačů aktuálně spravovaných nástrojem VMM.

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

-ExcludeVMMLibrary

Vyloučí servery knihoven aktuálně spravované nástrojem VMM.

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

-ExcludeVMs

Vyloučí virtuální počítače.

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

-FindHyperVHost

Vyhledá počítače se systémem Windows Server 2008 nebo novějším, na kterých je povolená role serveru Hyper-V.

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

-IPAddressRangeEnd

Určuje poslední IP adresu v rozsahu IP adres. Použijte s parametrem IPAddressRangeStart .

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

-IPAddressRangeStart

Určuje první IP adresu v rozsahu IP adres. Použijte s parametrem IPAddressRangeEnd .

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-RunAsynchronously

Označuje, že úloha se spouští asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

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

-SMBiosGuid

Určuje globálně jedinečný identifikátor systému BIOS (SMBIOS GUID) fyzického počítače, který je přidružený k záznamu pro tento fyzický počítač v nástroji VMM.

SMBIOS definuje datové struktury a metody přístupu, které uživateli nebo aplikaci umožňují ukládat a načítat informace o hardwaru na tomto počítači, například název systému, výrobce nebo verze systému BIOS. Operační systémy Windows načítají data SMBIOS při spuštění systému a zpřístupněte tato data programům.

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

-Subnet

Určuje podsíť PROTOKOLU IP (IPv4 nebo IPv6) v zápisu CIDR (Classless Inter-Domain Routing).

Příklad formátu podsítě IPv4: 192.168.0.1/24

Příklad formátu podsítě IPv6: FD4A:29CD:184F:3A2C::/64

Poznámka: Podsíť PROTOKOLU IP se nesmí překrývat s žádnou jinou podsítí ve skupině hostitelů nebo podřízených skupinách hostitelů.

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

-VMMServer

Určuje objekt serveru VMM.

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

Výstupy

Computer

Tato rutina vrátí objekt Computer .

Get-SCRunAsAccount

Sdílet prostřednictvím

Find-SCComputer

Syntax

Description

Příklady

Příklad 1: Hledání počítačů v konkrétní doméně, které splňují zadaná kritéria

Příklad 2: Vyhledání konkrétního počítače podle názvu a ověření jeho vlastností ve službě Active Directory

Příklad 3: Vyhledejte všechny počítače v zadané doméně, které nejsou serverem knihovny VMM.

Příklad 4: Vyhledání všech nespravovaných počítačů v zadané doméně pomocí dotazu služby Active Directory

Příklad 5: Vyhledání holých počítačů, které mají vzdálené řadiče, které jsou v určitém rozsahu sítě

Příklad 6: Provedení hloubkového zjišťování na fyzickém počítači s podporou holých počítačů

Parametry

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Výstupy

Další materiály

Sdílet prostřednictvím

Find-SCComputer

Syntax

Description

Příklady

Příklad 1: Hledání počítačů v konkrétní doméně, které splňují zadaná kritéria

Příklad 2: Vyhledání konkrétního počítače podle názvu a ověření jeho vlastností ve službě Active Directory

Příklad 3: Vyhledejte všechny počítače v zadané doméně, které nejsou serverem knihovny VMM.

Příklad 4: Vyhledání všech nespravovaných počítačů v zadané doméně pomocí dotazu služby Active Directory

Příklad 5: Vyhledání holých počítačů, které mají vzdálené řadiče, které jsou v určitém rozsahu sítě

Příklad 6: Provedení hloubkového zjišťování na fyzickém počítači s podporou holých počítačů

Parametry

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Výstupy

Související odkazy

Další materiály