Find-SCComputer

Referentie

Module:: VirtualMachineManager

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

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

De cmdlet Find-SCComputer 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 active Directory wordt doorzocht. 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 met de domeinparameter gebruikt, 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 Uitvoeren als-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 Uitvoeren als-accountobject met de naam BMC-account 01 opgehaald en wordt het object opgeslagen in de variabele $BMCRunAsAccount.

Met de derde opdracht wordt de diepe detectie op het computerobject uitgevoerd en wordt het object van de fysieke machine geretourneerd 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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BMCAddress

Hiermee geeft u het out-of-band BMC-adres (Baseboard Management Controller) voor een specifieke fysieke machine op. 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 bijbehorende 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 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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BMCCustomConfigurationProvider

Hiermee geeft u een configuratieproviderobject op voor een baseboard-beheercontroller (BMC). 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 aangepaste BMCProtocol.

Type:	ConfigurationProvider
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
SMASH
Aangepast telefoonnummer

Een BMC (ook wel bekend als een serviceprocessor of beheercontroller) is een gespecialiseerde controller op het moederbord van een server die een interface tussen de hardware- en systeembeheersoftware fungeert. 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
Accepted values:	IPMI, SMASH, Custom
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BMCRunAsAccount

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

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

-ComputerName

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

FQDN
IPv4- of IPv6-adres
NetBIOS-naam

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 gemachtigd is om deze actie uit te voeren. Of, in het geval van Restart-SCJob, is gemachtigd om een opnieuw opgestarte taak te voltooien.

Typ voor meer informatie over het PSCredential-object Get-Help Get-Credential.

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

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

-DeepDiscovery

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

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

-DiscoveryID

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

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

-Domain

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

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

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

-ExcludeVMMHost

Sluit virtuele-machinehosts uit die momenteel worden beheerd door VMM.

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

-ExcludeVMMLibrary

Sluit bibliotheekservers uit die momenteel worden beheerd door VMM.

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

-ExcludeVMs

Sluit virtuele machines uit.

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

-FindHyperVHost

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

Type:	SwitchParameter
Aliases:	FindHyperVHosts
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subnet

Hiermee geeft u een IP-subnet (IPv4 of IPv6) op in de CIDR-notatie (Classless Inter-Domain Routing).

Voorbeeldindeling voor een IPv4-subnet: 192.168.0.1/24

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

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

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

Computer

Deze cmdlet retourneert een computerobject .

Get-SCRunAsAccount

Delen via

Find-SCComputer

Syntax

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

Syntax

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