Find-SCComputer

Referenz

Modul:: VirtualMachineManager

Sucht nach Computern durch Abfragen von Active Directory und gibt die Computerobjekte zurück.

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>]

Beschreibung

Das Cmdlet "Find-SCComputer " sucht nach einem oder mehreren Computern, indem Sie Active Directory abfragen und die Computerobjekte zurückgeben.

Mithilfe dieses Cmdlets können Sie Active Directory nach Computern abfragen. Die Abfrage kann auf bestimmten Kriterien oder auf Kombinationen folgender Kriterien basieren:

Der vollqualifizierte Domänenname (FQDN) eines Computers.
Der Gesamte oder Teil des Computernamens.
Der Name einer Domäne.
Alle Computer außer Hosts, die von Virtual Machine Manager (VMM) verwaltet werden.
Alle Computer außer Bibliotheksservern, die von VMM verwaltet werden.
Nur Hyper-V-Hosts.
Bare-Metal-Computer mit Out-of-Band-Controllern.

Hinweis: Wenn Sie einen neuen Computer, z. B. einen Host- oder Bibliotheksserver, in einer Active Directory-Domäne zu VMM hinzufügen und dann sofort das Cmdlet Discover-Computer ausführen, wird das Cmdlet möglicherweise beim Durchsuchen von Active Directory möglicherweise nicht sofort den neuen Computer entdecken. Diese Verzögerung kann auftreten, da Daten über den neuen Computer möglicherweise noch nicht in der Active Directory-Domäne repliziert wurden. Als Domänenadministrator können Sie die Konsole "Active Directory-Standorte und -Dienste" verwenden, um das sofortige Replizieren der Daten zu erzwingen.

Beispiele

Beispiel 1: Suchen nach Computern in einer bestimmten Domäne, die den angegebenen Kriterien entsprechen

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

Der erste Befehl ruft das Run As-Kontoobjekt namens Host Computer Account 01 ab und speichert das Objekt in der $RunAsAccount Variablen.

Der zweite Befehl fragt Active Directory ab und gibt eine Liste von Hyper-V-Computerobjekten für Computer in der Domäne "Contoso.com" zurück, deren Name mit "host" beginnt und die nicht von VMM verwaltet werden. Da dieser Befehl verarbeitet wird, stellt $RunAsAccount Anmeldeinformationen für Find-SCComputer bereit.

Hinweis: Wenn Sie Find-SCComputer mit dem Parameter Domain verwenden, müssen Sie den vollqualifizierten Domänennamen angeben.

Beispiel 2: Suchen nach einem bestimmten Computer nach Namen und Überprüfen der Eigenschaften in Active Directory

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

Dieser Befehl verwendet den vollqualifizierten Domänennamen (FQDN) des Computers namens VMHost01, um diesen Computer in Active Directory zu finden, gibt das Computerobjekt zurück und zeigt die Computerobjekteigenschaften für den Benutzer an.

Beispiel 3: Suchen nach allen Computern in der angegebenen Domäne, die kein VMM-Bibliotheksserver sind

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

Der erste Befehl ruft das Run As-Kontoobjekt namens Host Computer Account 01 ab und speichert das Objekt in der $RunAsAccount Variablen.

Der zweite Befehl fragt Active Directory für alle Computer in der Contoso.com Domäne ab, die "vmm" im Computernamen mit Ausnahme von VMM-Bibliotheksservern enthalten. Da dieser Befehl verarbeitet wird, stellt $RunAsAccount Anmeldeinformationen für Find-SCComputer bereit.

Beispiel 4: Suchen aller nicht verwalteten Computer in der angegebenen Domäne mithilfe einer Active Directory-Abfrage

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

Der erste Befehl ruft das Run As-Kontoobjekt namens Host Computer Account 01 ab und speichert das Objekt in der $RunAsAccount Variablen.

Der zweite Befehl fragt Active Directory für alle Computer in der Contoso.com Domäne ab, die die Abfragekriterien erfüllen: alle Windows Server 2008 R2-Computer mit einem Namen, der mit Test0 beginnt, aber keine VMM-Bibliotheksserver oder VMM-Hosts sind. Da dieser Befehl verarbeitet wird, stellt $RunAsAccount Anmeldeinformationen für Find-SCComputer bereit.

Beispiel 5: Suchen von Bare-Metal-Computern mit Out-of-Band-Controllern, die sich innerhalb eines bestimmten Netzwerkbereichs befinden

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

Der erste Befehl ruft das Run As-Kontoobjekt namens BMC Account 01 ab und speichert das Objekt in der $BMCRunAsAccount Variablen.

Der zweite Befehl überprüft das Netzwerk nach einem physischen Computer mit dem angegebenen BMCAddress. Da dieser Befehl verarbeitet wird, stellt $BMCRunAsAccount Anmeldeinformationen für Find-SCComputer bereit.

Beispiel 6: Durchführen einer tiefen Ermittlung auf einem physischen Computer mit Bare-Metal-Computerunterstützung

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

Der erste Befehl ruft das Run As-Kontoobjekt namens BMC Account 01 ab und speichert das Objekt in der $BMCRunAsAccount Variablen.

Der dritte Befehl führt die deep Discovery auf dem Computerobjekt aus und gibt das physische Computerobjekt an $MyComputer 01-Variable zurück.

Der letzte Befehl zeigt die Eigenschaften des Computerobjekts an, das in der Variablen $MyComputer 01 gespeichert ist.

Parameter

-ADSearchFilter

Definiert eine Active Directory-Abfrage für die Ermittlung. Verwenden Sie diesen Parameter, um eine Abfrage anzugeben, die Active Directory-Domäneninformationen und Suchfilter enthält.

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

Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft.

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

-BMCAddress

Gibt die Out-of-Band-Baseboard-Verwaltungscontrolleradresse (BMC) für einen bestimmten physischen Computer an oder aktualisiert sie. Dies kann eine IP-Adresse, der vollqualifizierte Domänenname (FQDN) oder das DNS-Präfix sein (dies ist in der Regel derselbe Name wie der NetBIOS-Name).

In der Regel sind die BMC-Adresse und ihre Verbindung mit dem Netzwerk von der IP-Adresse getrennt, die einem Standardnetzwerkadapter zugeordnet ist. Alternativ verwenden einige Computer einen Standardnetzwerkadapter, um eine einzige Adresse für den BMC und den Netzwerkadapter bereitzustellen. Die BMC-Adresse weist jedoch einen eindeutigen Port auf und ist somit eindeutig identifizierbar im Netzwerk.

Beispiel-IPv4-Format: -BMCAddress "10.0.0.21"

Beispiel-Ipv6-Format: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Beispiel-FQDN-Format: -BMCAddress "Computer01.Contoso.com"

Beispiel für NetBIOS-Format: -BMCAddress "Computer01"

Hinweis: Standardmäßig verwendet VMM eine IP-Adresse oder einen FQDN für die BMC-Adresse. Es ist jedoch auch möglich, ein PowerShell-Modul zu erstellen, mit dem Sie andere Typen von Adressen als BMC-Adresse angeben können.

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

-BMCCustomConfigurationProvider

Gibt ein Konfigurationsanbieterobjekt für einen Baseboard-Verwaltungscontroller (BMC) an oder aktualisiert. Ein Konfigurationsanbieter ist ein Plug-In in VMM, das VMM PowerShell-Befehle in API-Aufrufe übersetzt, die für einen Typ des Baseboardverwaltungscontrollers spezifisch sind. Dieser Parameter sollte mit dem benutzerdefinierten BMCProtocol verwendet werden.

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

-BMCPort

Gibt den Out-of-Band-Baseboard-Verwaltungscontroller (BMC) für einen bestimmten physischen Computer an oder aktualisiert sie. Ein BMC-Port wird auch als Dienstprozessorport bezeichnet. Beispielstandardports sind 623 für IPMI und 443 für SMASH über WS-Man.

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

-BMCProtocol

Gibt das Protokoll an, das VMM verwendet, um mit dem Out-of-Band-Baseboard-Verwaltungscontroller (BMC) zu kommunizieren. Gültige Werte sind:

IPMI
SMASH
Benutzerdefiniert

Ein BMC (auch als Dienstprozessor oder Verwaltungscontroller bezeichnet) ist ein spezieller Controller auf dem Motherboard eines Servers, der eine Schnittstelle zwischen der Hardware- und Systemverwaltungssoftware fungiert. Wenn das Motherboard eines physischen Computers einen BMC enthält, wenn der Computer angeschlossen ist (unabhängig davon, ob es ausgeschaltet oder eingeschaltet ist, und ob ein Betriebssystem installiert ist), finden Sie Informationen zur Systemhardware und zum Zustand dieser Systemhardware.

Beispielformat: -BMCProtocol "Custom"

Hinweis: Das benutzerdefinierte Protokoll erfordert, dass Sie den Parameter BMCCustomConfigurationProvider verwenden.

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

-BMCRunAsAccount

Gibt das Run As-Konto an, das mit dem BMC-Gerät (Baseboard Management Controller) verwendet werden soll.

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

-ComputerName

Gibt den Namen eines Computers an, der von VMM eindeutig im Netzwerk identifiziert werden kann. Zulässige Werte für diesen Parameter:

FQDN
IPv4- oder IPv6-Adresse
NetBIOS-Name

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

-ComputerNameFilter

Gibt den Namen des Computers, der vom Cmdlet in Active Directory gesucht werden soll, ganz oder teilweise an.

Beispielformat: -ComputerNameFilter "host"

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

-Credential

Gibt ein Anmeldeinformationsobjekt oder für einige Cmdlets ein Run As-Kontoobjekt an, das den Benutzernamen und das Kennwort eines Kontos enthält, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Oder im Falle von Restart-SCJob hat die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.

Geben Sie weitere Informationen zum PSCredential-Objekt ein Get-Help Get-Credential.

Weitere Informationen zum Ausführen als Konten geben Sie Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Gibt an, dass die Deep Discovery für den angegebenen Computer verwendet wird.

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

-DiscoveryID

Nur zur internen Verwendung (nicht zur Verwendung in Ihrem Code).

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

-Domain

Gibt einen vollqualifizierten Domänennamen (FQDN) für eine Active Directory-Domäne an.

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

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

-ExcludeVMMHost

Schließt virtuelle Computerhosts aus, die derzeit von VMM verwaltet werden.

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

-ExcludeVMMLibrary

Schließt zurzeit von VMM verwaltete Bibliothekserver aus.

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

-ExcludeVMs

Schließt virtuelle Computer aus.

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

-FindHyperVHost

Sucht nach Computern mit Windows Server 2008 oder höher, auf denen die Hyper-V-Serverrolle aktiviert ist.

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

-IPAddressRangeEnd

Gibt die letzte IP-Adresse in einem Bereich von IP-Adressen an. Verwenden Sie den PARAMETER IPAddressRangeStart .

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

-IPAddressRangeStart

Gibt die erste IP-Adresse in einem Bereich von IP-Adressen an. Verwenden Sie den Parameter "IPAddressRangeEnd" .

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-SMBiosGuid

Gibt den global eindeutigen Bezeichner (System Management BIOS, SMBIOS GUID) für einen physischen Computer an, der einem Datensatz für diesen physischen Computer in VMM zugeordnet ist.

SMBIOS definiert Datenstrukturen und Zugriffsmethoden, die es einem Benutzer oder einer Anwendung ermöglichen, Informationen zu Hardware auf diesem Computer zu speichern und abzurufen, z. B. den Namen des Systems, des Herstellers oder der System-BIOS-Version. Windows-Betriebssysteme rufen SMBIOS-Daten beim Systemstart ab und stellen diese Daten für Programme zur Verfügung.

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

-Subnet

Gibt ein IP-Subnetz (IPv4 oder IPv6) in classless Inter-Domain Routing (CIDR) Notation an.

Beispielformat für ein IPv4-Subnetz: 192.168.0.1/24

Beispielformat für ein IPv6-Subnetz: FD4A:29CD:184F:3A2C::/64

Hinweis: Ein IP-Subnetz kann nicht mit einem anderen Subnetz in einer Hostgruppe oder untergeordneten Hostgruppen überlappen.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

Computer

Dieses Cmdlet gibt ein Computerobjekt zurück.

Get-SCRunAsAccount

Freigeben über

Find-SCComputer

Syntax

Beschreibung

Beispiele

Beispiel 1: Suchen nach Computern in einer bestimmten Domäne, die den angegebenen Kriterien entsprechen

Beispiel 2: Suchen nach einem bestimmten Computer nach Namen und Überprüfen der Eigenschaften in Active Directory

Beispiel 3: Suchen nach allen Computern in der angegebenen Domäne, die kein VMM-Bibliotheksserver sind

Beispiel 4: Suchen aller nicht verwalteten Computer in der angegebenen Domäne mithilfe einer Active Directory-Abfrage

Beispiel 5: Suchen von Bare-Metal-Computern mit Out-of-Band-Controllern, die sich innerhalb eines bestimmten Netzwerkbereichs befinden

Beispiel 6: Durchführen einer tiefen Ermittlung auf einem physischen Computer mit Bare-Metal-Computerunterstützung

Parameter

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Ausgaben

Zusätzliche Ressourcen

Freigeben über

Find-SCComputer

Syntax

Beschreibung

Beispiele

Beispiel 1: Suchen nach Computern in einer bestimmten Domäne, die den angegebenen Kriterien entsprechen

Beispiel 2: Suchen nach einem bestimmten Computer nach Namen und Überprüfen der Eigenschaften in Active Directory

Beispiel 3: Suchen nach allen Computern in der angegebenen Domäne, die kein VMM-Bibliotheksserver sind

Beispiel 4: Suchen aller nicht verwalteten Computer in der angegebenen Domäne mithilfe einer Active Directory-Abfrage

Beispiel 5: Suchen von Bare-Metal-Computern mit Out-of-Band-Controllern, die sich innerhalb eines bestimmten Netzwerkbereichs befinden

Beispiel 6: Durchführen einer tiefen Ermittlung auf einem physischen Computer mit Bare-Metal-Computerunterstützung

Parameter

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Ausgaben

Ähnliche Themen

Zusätzliche Ressourcen