Find-SCComputer

Referentie

Module:: VirtualMachineManager

Zoekt naar computers door een query uit te voeren op Active Directory en retourneert de computerobjecten.

Syntaxis

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

De Find-SCComputer cmdlet zoekt naar een of meer computers door een query uit te voeren op Active Directory en retourneert de computerobjecten.

U kunt deze cmdlet gebruiken om een query uit te voeren op Active Directory voor computers op basis van opgegeven criteria of een combinatie van criteria, waaronder:

De FQDN (Fully Qualified Domain Name) van een computer.
Alle of een deel van de computernaam.
De naam van een domein.
Alle computers behalve hosts die worden beheerd door Virtual Machine Manager (VMM).
Alle computers behalve bibliotheekservers die worden beheerd door VMM.
Alleen Hyper-V hosts.
Bare-metalcomputers met out-of-band controllers.

Opmerking: Als u een nieuwe computer, zoals een host- of bibliotheekserver, in een Active Directory-domein aan VMM toevoegt en vervolgens onmiddellijk de cmdlet Discover-Computer uitvoert, wordt de nieuwe computer mogelijk niet onmiddellijk gedetecteerd wanneer er wordt gezocht in Active Directory. Deze vertraging kan optreden omdat gegevens over de nieuwe computer mogelijk nog niet zijn gerepliceerd in het Active Directory-domein. Als u een domeinbeheerder bent, kunt u de Active Directory-sites en -services-console gebruiken om de gegevens onmiddellijk te repliceren.

Voorbeelden

Voorbeeld 1: Zoeken naar computers in een specifiek domein die voldoen aan de opgegeven criteria

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

Met de eerste opdracht wordt het Run As-accountobject met de naam Host Computer Account 01 opgehaald en wordt het object opgeslagen in de $RunAsAccount variabele.

De tweede opdracht voert een query uit op Active Directory en retourneert een lijst met Hyper-V computerobjecten voor computers die zich in het Contoso.com domein bevinden, die een naam hebben die begint met 'host' en die niet worden beheerd door VMM. Terwijl deze opdracht wordt verwerkt, biedt $RunAsAccount referenties voor Find-SCComputer-.

Opmerking: wanneer u Find-SCComputer- gebruikt met de parameter Domain, moet u de volledig gekwalificeerde domeinnaam opgeven.

Voorbeeld 2: Zoeken naar een specifieke computer op naam en de eigenschappen ervan valideren in Active Directory

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

Deze opdracht maakt gebruik van de FQDN (Fully Qualified Domain Name) van de computer met de naam VMHost01 om deze computer te vinden in Active Directory, retourneert het computerobject en geeft de eigenschappen van het computerobject weer aan de gebruiker.

Voorbeeld 3: Zoeken naar alle computers in het opgegeven domein die geen VMM-bibliotheekserver zijn

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

Met de eerste opdracht wordt het Run As-accountobject met de naam Host Computer Account 01 opgehaald en wordt het object opgeslagen in de $RunAsAccount variabele.

Met de tweede opdracht wordt Active Directory opgevraagd voor alle computers in het Contoso.com-domein met 'vmm' in de computernaam, met uitzondering van VMM-bibliotheekservers. Terwijl deze opdracht wordt verwerkt, biedt $RunAsAccount referenties voor Find-SCComputer-.

Voorbeeld 4: Alle niet-beheerde computers in het opgegeven domein zoeken met behulp van een Active Directory-query

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

Met de eerste opdracht wordt het Run As-accountobject met de naam Host Computer Account 01 opgehaald en wordt het object opgeslagen in de $RunAsAccount variabele.

Met de tweede opdracht wordt Active Directory opgevraagd voor alle computers in het Contoso.com-domein die voldoen aan de querycriteria: elke Windows Server 2008 R2-computer met een naam die begint met Test0, maar die geen VMM-bibliotheekservers of VMM-hosts zijn. Terwijl deze opdracht wordt verwerkt, biedt $RunAsAccount referenties voor Find-SCComputer-.

Voorbeeld 5: Zoek bare-metalcomputers met out-of-band controllers die zich binnen een specifiek netwerkbereik bevinden

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

Met de eerste opdracht wordt het Run As-accountobject met de naam BMC Account 01 opgehaald en wordt het object opgeslagen in de variabele $BMCRunAsAccount.

Met de tweede opdracht wordt het netwerk gescand op een fysieke computer met het opgegeven BMCAddress. Terwijl deze opdracht wordt verwerkt, biedt $BMCRunAsAccount referenties voor Find-SCComputer-.

Voorbeeld 6: Grondige detectie uitvoeren op een fysieke machine met ondersteuning voor bare-metalcomputers

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

Met de eerste opdracht wordt het Run As-accountobject met de naam BMC Account 01 opgehaald en wordt het object opgeslagen in de variabele $BMCRunAsAccount.

De derde opdracht voert de diepe detectie uit op het computerobject en retourneert het object van de fysieke machine naar $MyComputer 01 variabele.

Met de laatste opdracht worden de eigenschappen weergegeven van het computerobject dat is opgeslagen in de variabele $MyComputer 01.

Parameters

-ADSearchFilter

Hiermee definieert u een Active Directory-query voor detectie. Gebruik deze parameter om een query op te geven die Active Directory-domeingegevens en zoekfilters bevat.

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

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-All

Geeft aan dat met deze cmdlet alle onderliggende objecten onafhankelijk van het bovenliggende object worden opgehaald.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCAddress

Hiermee geeft u het out-of-band BMC-adres (Baseboard Management Controller) op voor een specifieke fysieke machine. Dit kan een IP-adres, de FQDN (Fully Qualified Domain Name) of het DNS-voorvoegsel zijn (meestal dezelfde naam als de NetBIOS-naam).

Normaal gesproken zijn het BMC-adres en de verbinding met het netwerk gescheiden van het IP-adres dat is gekoppeld aan een standaardnetwerkadapter. Sommige computers gebruiken ook een standaardnetwerkadapter om één adres voor de BMC en voor de netwerkadapter op te geven. Het BMC-adres heeft echter een unieke poort en is dus uniek identificeerbaar op het netwerk.

Voorbeeld van IPv4-indeling: -BMCAddress "10.0.0.21"

Voorbeeld van ipv6-indeling: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Voorbeeld van FQDN-indeling: -BMCAddress "Computer01.Contoso.com"

Voorbeeld van NetBIOS-indeling: -BMCAddress "Computer01"

Opmerking: VMM gebruikt standaard een IP-adres of FQDN voor het BMC-adres. Het is echter ook mogelijk om een PowerShell-module te maken waarmee u andere typen adressen kunt opgeven als het BMC-adres.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCCustomConfigurationProvider

Hiermee geeft u een configuratieproviderobject op voor een BMC (Baseboard Management Controller). Een configuratieprovider is een invoegtoepassing voor VMM die VMM PowerShell-opdrachten vertaalt naar API-aanroepen die specifiek zijn voor een type baseboard-beheercontroller. Deze parameter moet worden gebruikt met het Custom BMCProtocol.

Type:	ConfigurationProvider
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCPort

Hiermee geeft u de out-of-band BMC-poort (Baseboard Management Controller) op voor een specifieke fysieke machine. Een BMC-poort wordt ook wel een serviceprocessorpoort genoemd. Voorbeeld van standaardpoorten zijn 623 voor IPMI en 443 voor SMASH via WS-Man.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCProtocol

Hiermee geeft u het protocol op dat door VMM wordt gebruikt om te communiceren met de out-of-band baseboard management controller (BMC). Geldige waarden zijn:

IPMI
VERPLETTEREN
Gewoonte

Een BMC (ook wel een serviceprocessor of beheercontroller genoemd) is een gespecialiseerde controller op het moederbord van een server die een interface tussen de hardware- en systeembeheersoftware uitvoert. Als het moederbord van een fysieke machine een BMC bevat, wanneer de machine is aangesloten (of deze is uitgeschakeld of ingeschakeld en of een besturingssysteem is geïnstalleerd), informatie over systeemhardware en de status van die systeemhardware beschikbaar is.

Voorbeeldindeling: -BMCProtocol "Custom"

Opmerking: Voor het aangepaste protocol moet u de parameter BMCCustomConfigurationProvider gebruiken.

Type:	OutOfBandManagementType
Geaccepteerde waarden:	IPMI, SMASH, Custom
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BMCRunAsAccount

Hiermee geeft u het Uitvoeren als-account dat moet worden gebruikt met het BMC-apparaat (Baseboard Management Controller).

Type:	RunAsAccount
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ComputerName

Hiermee geeft u de naam op van een computer die VMM uniek kan identificeren in uw netwerk. De acceptabele waarden voor deze parameter zijn:

FQDN
IPv4- of IPv6-adres
NetBIOS-naam

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ComputerNameFilter

Hiermee geeft u de gedeeltelijke of volledige naam van een computer die de cmdlet probeert te detecteren in Active Directory.

Voorbeeldindeling: -ComputerNameFilter "host"

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Credential

Hiermee geeft u een referentieobject of, voor sommige cmdlets, een Uitvoeren als-accountobject met de gebruikersnaam en het wachtwoord van een account dat is gemachtigd om deze actie uit te voeren. Of, in het geval van Restart-SCJob, is gemachtigd om een opnieuw gestarte taak te voltooien.

Typ Get-Help Get-Credentialvoor meer informatie over het PSCredential-object.

Typ Get-Help New-SCRunAsAccountvoor meer informatie over Uitvoeren als-accounts.

Type:	VMMCredential
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DeepDiscovery

Geeft aan dat diepe detectie wordt gebruikt voor de opgegeven computer.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DiscoveryID

Alleen voor intern gebruik (niet voor gebruik in uw code).

Type:	Guid
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Domain

Hiermee geeft u een FQDN (Fully Qualified Domain Name) voor een Active Directory-domein.

Voorbeeldindeling: -Domain "Domain01.Corp.Contoso.com"

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ExcludeVMMHost

Hiermee worden virtuele-machinehosts uitgesloten die momenteel worden beheerd door VMM.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ExcludeVMMLibrary

Sluit bibliotheekservers uit die momenteel worden beheerd door VMM.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ExcludeVMs

Virtuele machines worden uitgesloten.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-FindHyperVHost

Hiermee wordt gezocht naar computers met Windows Server 2008 of hoger waarop de Hyper-V-serverfunctie is ingeschakeld.

Type:	SwitchParameter
Aliassen:	FindHyperVHosts
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IPAddressRangeEnd

Hiermee geeft u het laatste IP-adres in een bereik van IP-adressen. Gebruik deze met de parameter IPAddressRangeStart.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IPAddressRangeStart

Hiermee geeft u het eerste IP-adres in een bereik van IP-adressen. Gebruik deze met de parameter IPAddressRangeEnd.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SMBiosGuid

Hiermee geeft u de SYSTEM Management BIOS globally unique identifier (SMBIOS GUID) voor een fysieke computer die is gekoppeld aan een record voor die fysieke computer in VMM.

SMBIOS definieert gegevensstructuren en toegangsmethoden waarmee een gebruiker of toepassing informatie over hardware op deze computer kan opslaan en ophalen, zoals de naam van het systeem, de fabrikant of de BIOS-versie van het systeem. Windows-besturingssystemen halen SMBIOS-gegevens op bij het opstarten van het systeem en maken die gegevens beschikbaar voor programma's.

Type:	Guid
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Subnet

Hiermee geeft u een IP-subnet (IPv4 of IPv6) in classless Inter-Domain routing (CIDR) notatie.

Voorbeeldindeling voor een IPv4-subnet: 192.168.0.1/24

Voorbeeldindeling voor een IPv6-subnet: FD4A:29CD:184F:3A2C::/64

Opmerking: een IP-subnet mag niet overlappen met een ander subnet in een hostgroep of onderliggende hostgroepen.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:	ServerConnection
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Uitvoerwaarden

Computer

Deze cmdlet retourneert een Computer-object.

Get-SCRunAsAccount

Delen via

Find-SCComputer

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Zoeken naar computers in een specifiek domein die voldoen aan de opgegeven criteria

Voorbeeld 2: Zoeken naar een specifieke computer op naam en de eigenschappen ervan valideren in Active Directory

Voorbeeld 3: Zoeken naar alle computers in het opgegeven domein die geen VMM-bibliotheekserver zijn

Voorbeeld 4: Alle niet-beheerde computers in het opgegeven domein zoeken met behulp van een Active Directory-query

Voorbeeld 5: Zoek bare-metalcomputers met out-of-band controllers die zich binnen een specifiek netwerkbereik bevinden

Voorbeeld 6: Grondige detectie uitvoeren op een fysieke machine met ondersteuning voor bare-metalcomputers

Parameters

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Uitvoerwaarden

Aanvullende resources

Delen via

Find-SCComputer

Syntaxis

Description

Voorbeelden

Voorbeeld 1: Zoeken naar computers in een specifiek domein die voldoen aan de opgegeven criteria

Voorbeeld 2: Zoeken naar een specifieke computer op naam en de eigenschappen ervan valideren in Active Directory

Voorbeeld 3: Zoeken naar alle computers in het opgegeven domein die geen VMM-bibliotheekserver zijn

Voorbeeld 4: Alle niet-beheerde computers in het opgegeven domein zoeken met behulp van een Active Directory-query

Voorbeeld 5: Zoek bare-metalcomputers met out-of-band controllers die zich binnen een specifiek netwerkbereik bevinden

Voorbeeld 6: Grondige detectie uitvoeren op een fysieke machine met ondersteuning voor bare-metalcomputers

Parameters

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Uitvoerwaarden

Verwante koppelingen

Aanvullende resources