Find-SCComputer

Referens

Modul:: VirtualMachineManager

Söker efter datorer genom att fråga Active Directory och returnerar datorobjekten.

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

Cmdleten Find-SCComputer söker efter en eller flera datorer genom att fråga Active Directory och returnerar datorobjekten.

Du kan använda den här cmdleten för att fråga Active Directory efter datorer baserat på angivna kriterier, eller en kombination av kriterier, inklusive:

Det fullständigt kvalificerade domännamnet (FQDN) för en dator.
Hela eller delar av datornamnet.
Namnet på en domän.
Alla datorer utom värdar som hanteras av Virtual Machine Manager (VMM).
Alla datorer utom biblioteksservrar som hanteras av VMM.
Endast Hyper-V-värdar.
Datorer utan operativsystem som har out-of-band-styrenheter.

Obs! Om du lägger till en ny dator, till exempel en värd eller biblioteksserver, som finns i en Active Directory-domän i VMM och sedan omedelbart kör cmdleten Discover-Computer kanske cmdleten inte omedelbart identifierar den nya datorn när den söker i Active Directory. Den här fördröjningen kan inträffa eftersom data om den nya datorn kanske inte har replikerats ännu i Active Directory-domänen. Om du är domänadministratör kan du använda Active Directory-konsolen Platser och tjänster för att tvinga data att replikeras omedelbart.

Exempel

Exempel 1: Sök efter datorer i en specifik domän som uppfyller de angivna kriterierna

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

Det första kommandot hämtar Kör som-kontoobjektet med namnet Värddatorkonto 01 och lagrar objektet i variabeln $RunAsAccount.

Det andra kommandot frågar Active Directory och returnerar en lista över Hyper-V-datorobjekt för datorer som finns i Contoso.com-domänen, som har ett namn som börjar med "värd" och som inte hanteras av VMM. När det här kommandot bearbetas tillhandahåller $RunAsAccount autentiseringsuppgifter till Find-SCComputer.

Obs! När du använder Find-SCComputer med domänparametern måste du ange det fullständigt kvalificerade domännamnet.

Exempel 2: Sök efter en specifik dator efter namn och verifiera dess egenskaper i Active Directory

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

Det här kommandot använder det fullständigt kvalificerade domännamnet (FQDN) för datorn VMHost01 för att hitta den här datorn i Active Directory, returnerar datorobjektet och visar egenskaperna för datorobjektet för användaren.

Exempel 3: Sök efter alla datorer i den angivna domänen som inte är en VMM-biblioteksserver

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

Det första kommandot hämtar Kör som-kontoobjektet med namnet Värddatorkonto 01 och lagrar objektet i variabeln $RunAsAccount.

Det andra kommandot frågar Active Directory för alla datorer i Contoso.com domän som innehåller "vmm" i datornamnet förutom VMM-biblioteksservrar. När det här kommandot bearbetas tillhandahåller $RunAsAccount autentiseringsuppgifter till Find-SCComputer.

Exempel 4: Hitta alla ohanterade datorer i den angivna domänen med hjälp av en Active Directory-fråga

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

Det första kommandot hämtar Kör som-kontoobjektet med namnet Värddatorkonto 01 och lagrar objektet i variabeln $RunAsAccount.

Det andra kommandot frågar Active Directory för alla datorer i Contoso.com domän som uppfyller frågekriterierna: alla Windows Server 2008 R2-datorer med ett namn som börjar med Test0 men som inte är VMM-biblioteksservrar eller VMM-värdar. När det här kommandot bearbetas tillhandahåller $RunAsAccount autentiseringsuppgifter till Find-SCComputer.

Exempel 5: Hitta datorer utan operativsystem som har out-of-band-styrenheter som ligger inom ett visst nätverksintervall

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

Det första kommandot hämtar Kör som-kontoobjektet med namnet BMC-konto 01 och lagrar objektet i variabeln $BMCRunAsAccount.

Det andra kommandot söker igenom nätverket efter en fysisk dator med angiven BMCAddress. När det här kommandot bearbetas tillhandahåller $BMCRunAsAccount autentiseringsuppgifter till Find-SCComputer.

Exempel 6: Utföra djupidentifiering på en fysisk dator med datorstöd utan operativsystem

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

Det första kommandot hämtar Kör som-kontoobjektet med namnet BMC-konto 01 och lagrar objektet i variabeln $BMCRunAsAccount.

Det tredje kommandot utför djupidentifieringen på datorobjektet och returnerar det fysiska datorobjektet till variabeln $MyComputer 01.

Det sista kommandot visar egenskaperna för datorobjektet som lagras i variabeln $MyComputer 01.

Parametrar

-ADSearchFilter

Definierar en Active Directory-fråga för identifiering. Använd den här parametern för att ange en fråga som innehåller Active Directory-domäninformation och sökfilter.

Exempelformat: -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

Anger att den här cmdleten hämtar alla underordnade objekt oberoende av det överordnade objektet.

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

-BMCAddress

Anger, eller uppdaterar, BMC-adressen (out-of-band baseboard management controller) för en specifik fysisk dator. Detta kan vara en IP-adress, det fullständigt kvalificerade domännamnet (FQDN) eller DNS-prefixet (som vanligtvis är samma namn som NetBIOS-namnet).

Vanligtvis är BMC-adressen och dess anslutning till nätverket åtskilda från IP-adressen som är associerad med ett standardnätverkskort. Vissa datorer använder också ett standardnätverkskort för att ange en enda adress för BMC och för nätverkskortet. BMC-adressen har dock en unik port och är därmed unikt identifierbar i nätverket.

Exempel på IPv4-format: -BMCAddress "10.0.0.21"

Exempel på Ipv6-format: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Exempel på FQDN-format: -BMCAddress "Computer01.Contoso.com"

Exempel på NetBIOS-format: -BMCAddress "Computer01"

Obs! Som standard använder VMM en IP-adress eller FQDN för BMC-adressen. Men det går också att skapa en PowerShell-modul som gör att du kan ange andra typer av adresser som BMC-adress.

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

-BMCCustomConfigurationProvider

Anger, eller uppdaterar, ett konfigurationsproviderobjekt för en BMC (Baseboard Management Controller). En konfigurationsprovider är ett plugin-program till VMM som översätter VMM PowerShell-kommandon till API-anrop som är specifika för en typ av baseboard-hanteringskontrollant. Den här parametern ska användas med Custom BMCProtocol.

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

-BMCPort

Anger, eller uppdaterar, BMC-porten (out-of-band baseboard management controller) för en specifik fysisk dator. En BMC-port kallas även för en tjänstprocessorport. Exempel på standardportar är 623 för IPMI och 443 för SMASH over WS-Man.

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

-BMCProtocol

Anger, eller uppdaterar, det protokoll som VMM använder för att kommunicera med BMC (out-of-band baseboard management controller). Giltiga värden är:

IPMI
SMASH
Anpassat

En BMC (även känd som en tjänstprocessor eller hanteringskontrollant) är en specialiserad styrenhet på moderkortet på en server som fungerar som ett gränssnitt mellan maskinvaran och systemhanteringsprogramvaran. Om moderkortet för en fysisk dator innehåller en BMC, när datorn är ansluten (oavsett om den är avstängd eller påslagen, och om ett operativsystem är installerat eller inte), finns information om systemmaskinvara och tillståndet för systemets maskinvaruhälsa tillgänglig.

Exempelformat: -BMCProtocol "Custom"

Obs! Det anpassade protokollet kräver att du använder parametern BMCCustomConfigurationProvider .

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

-BMCRunAsAccount

Anger det Kör som-konto som ska användas med BMC-enheten (Baseboard Management Controller).

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

-ComputerName

Anger namnet på en dator som VMM unikt kan identifiera i nätverket. De acceptabla värdena för den här parametern är:

FQDN
IPv4- eller IPv6-adress
NetBIOS-namn

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

-ComputerNameFilter

Anger det partiella eller fullständiga namnet på en dator som cmdleten ska försöka identifiera i Active Directory.

Exempelformat: -ComputerNameFilter "host"

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

-Credential

Anger ett autentiseringsobjekt eller, för vissa cmdletar, ett Kör som-kontoobjekt som innehåller användarnamn och lösenord för ett konto som har behörighet att utföra den här åtgärden. Eller, när det gäller Restart-SCJob, har behörighet att slutföra en omstartad uppgift.

Mer information om PSCredential-objektet Get-Help Get-Credentialfinns i .

Om du vill ha mer information om Kör som-konton skriver du Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Anger att djupidentifiering används för den angivna datorn.

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

-DiscoveryID

Endast för internt bruk (inte för användning i koden).

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

-Domain

Anger ett fullständigt kvalificerat domännamn (FQDN) för en Active Directory-domän.

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

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

-ExcludeVMMHost

Exkluderar virtuella datorvärdar som för närvarande hanteras av VMM.

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

-ExcludeVMMLibrary

Exkluderar biblioteksservrar som för närvarande hanteras av VMM.

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

-ExcludeVMs

Exkluderar virtuella datorer.

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

-FindHyperVHost

Söker efter datorer som kör Windows Server 2008 eller senare där Hyper-V-serverrollen är aktiverad.

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

-IPAddressRangeEnd

Anger den sista IP-adressen i ett intervall med IP-adresser. Använd med parametern IPAddressRangeStart .

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

-IPAddressRangeStart

Anger den första IP-adressen i ett intervall med IP-adresser. Använd med parametern IPAddressRangeEnd .

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

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln som heter av den här parametern.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-SMBiosGuid

Anger systemhanterings-BIOS globalt unik identifierare (SMBIOS GUID) för en fysisk dator som är associerad med en post för den fysiska datorn i VMM.

SMBIOS definierar datastrukturer och åtkomstmetoder som gör det möjligt för en användare eller ett program att lagra och hämta information om maskinvara på den här datorn, till exempel namnet på systemet, tillverkaren eller systemets BIOS-version. Windows-operativsystem hämtar SMBIOS-data vid systemstart och gör dessa data tillgängliga för program.

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

-Subnet

Anger ett IP-undernät (IPv4 eller IPv6) i CIDR-notation (Classless Inter-Domain Routing).

Exempelformat för ett IPv4-undernät: 192.168.0.1/24

Exempelformat för ett IPv6-undernät: FD4A:29CD:184F:3A2C::/64

Obs! Ett IP-undernät kan inte överlappa något annat undernät i en värdgrupp eller underordnade värdgrupper.

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

-VMMServer

Anger ett VMM-serverobjekt.

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

Utdata

Computer

Den här cmdleten returnerar ett datorobjekt .

Get-SCRunAsAccount

Dela via

Find-SCComputer

Syntax

Description

Exempel

Exempel 1: Sök efter datorer i en specifik domän som uppfyller de angivna kriterierna

Exempel 2: Sök efter en specifik dator efter namn och verifiera dess egenskaper i Active Directory

Exempel 3: Sök efter alla datorer i den angivna domänen som inte är en VMM-biblioteksserver

Exempel 4: Hitta alla ohanterade datorer i den angivna domänen med hjälp av en Active Directory-fråga

Exempel 5: Hitta datorer utan operativsystem som har out-of-band-styrenheter som ligger inom ett visst nätverksintervall

Exempel 6: Utföra djupidentifiering på en fysisk dator med datorstöd utan operativsystem

Parametrar

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Utdata

Ytterligare resurser

Dela via

Find-SCComputer

Syntax

Description

Exempel

Exempel 1: Sök efter datorer i en specifik domän som uppfyller de angivna kriterierna

Exempel 2: Sök efter en specifik dator efter namn och verifiera dess egenskaper i Active Directory

Exempel 3: Sök efter alla datorer i den angivna domänen som inte är en VMM-biblioteksserver

Exempel 4: Hitta alla ohanterade datorer i den angivna domänen med hjälp av en Active Directory-fråga

Exempel 5: Hitta datorer utan operativsystem som har out-of-band-styrenheter som ligger inom ett visst nätverksintervall

Exempel 6: Utföra djupidentifiering på en fysisk dator med datorstöd utan operativsystem

Parametrar

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Utdata

Relaterade länkar

Ytterligare resurser