Find-SCComputer

Reference

Modul:: VirtualMachineManager

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

Syntaxe

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 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 Hyper-V hostitelé.
Holé počítače, které mají vzdálené řadiče.

Poznámka: Pokud do nástroje VMM přidáte nový počítač, například hostitelský server nebo server knihovny, který se nachází v doméně služby Active Directory, a potom okamžitě spustíte rutinu Discover-Computer, nemusí rutina při hledání ve službě 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 se ještě nemusí replikovat v rámci domény služby Active Directory. Pokud jste správcem domény, můžete pomocí konzoly lokality a služeb služby Active Directory 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 Hyper-V počítačových objektů 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: Při použití 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 pomocí plně kvalifikovaného názvu domény počítače s názvem VMHost01 vyhledá tento počítač ve službě Active Directory, vrátí objekt počítače a zobrazí vlastnosti objektu počítače uživateli.

Příklad 3: Vyhledání všech počítačů 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 se dotazuje služby Active Directory pro všechny počítače v doméně Contoso.com, která v názvu počítače obsahuje "vmm" 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 se dotazuje služby Active Directory pro všechny počítače v doméně Contoso.com, která splňují kritéria dotazu: jakýkoli počítač se systémem Windows Server 2008 R2 s názvem začínajícím nástrojem Test0, který ale není serverem knihovny VMM ani hostiteli 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 $BMCRunAsAccount proměnné.

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 $BMCRunAsAccount proměnné.

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 zadání 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*))"

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-All

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BMCAddress

Určuje nebo aktualizuje adresu řadiče pro správu základní desky (BMC) mimo pásmo pro konkrétní fyzický počítač. Může se jednat o IP adresu, plně kvalifikovaný název domény (FQDN) 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. Některé počítače také 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 má ale jedinečný port, který je tak jednoznač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í používá nástroj VMM PRO adresu řadiče pro správu základní desky IP adresu nebo plně kvalifikovaný název domény. 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.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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 pro správu základní desky. Tento parametr by se měl použít s custom BMCProtocol.

Typ:	ConfigurationProvider
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BMCPort

Určuje nebo aktualizuje port řadiče pro správu základní desky (BMC) mimo pásmo 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říkladem výchozích portů je 623 pro IPMI a 443 pro SMASH přes WS-Man.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-BMCProtocol

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

IPMI
SMEČ
Zvyk

Řadič pro správu základní desky (označovaný také jako procesor služeb nebo řadič pro správu) je specializovaný kontroler na základní desce serveru, který funguje jako 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, zda je vypnutý nebo zapnutý a zda je nainstalován operační systém), informace o hardwaru systému a stavu tohoto systému je k dispozici.

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

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

Typ:	OutOfBandManagementType
Přípustné hodnoty:	IPMI, SMASH, Custom
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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).

Typ:	RunAsAccount
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ComputerName

Určuje název počítače, který může nástroj VMM jednoznačně identifikovat v síti. Přijatelné hodnoty pro tento parametr jsou:

FQDN
Adresa IPv4 nebo IPv6
Název rozhraní NetBIOS

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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"

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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-SCJobmá oprávnění k dokončení restartované úlohy.

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

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

Typ:	VMMCredential
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DeepDiscovery

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DiscoveryID

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

Typ:	Guid
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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"

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExcludeVMMHost

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExcludeVMMLibrary

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExcludeVMs

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	SwitchParameter
Aliasy:	FindHyperVHosts
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IPAddressRangeEnd

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IPAddressRangeStart

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RunAsynchronously

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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 v 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í tato data programům.

Typ:	Guid
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Subnet

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

Příklad formátu pro podsíť 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ů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-VMMServer

Určuje objekt serveru VMM.

Typ:	ServerConnection
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Výstupy

Computer

Tato rutina vrátí objekt Computer.

Get-SCRunAsAccount

Sdílet prostřednictvím

Find-SCComputer

Syntaxe

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: Vyhledání všech počítačů 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

Syntaxe

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: Vyhledání všech počítačů 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