Find-SCComputer

Odwołanie

Moduł:: VirtualMachineManager

Wyszukuje komputery, wysyłając zapytanie do usługi Active Directory i zwracając obiekty komputera.

Składnia

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

Opis

Polecenie cmdlet Find-SCComputer wyszukuje co najmniej jeden komputer, wysyłając zapytanie do usługi Active Directory i zwracając obiekty komputera.

To polecenie cmdlet służy do wykonywania zapytań w usłudze Active Directory dla komputerów na podstawie określonych kryteriów lub kombinacji kryteriów, w tym:

W pełni kwalifikowana nazwa domeny (FQDN) komputera.
Wszystkie lub część nazwy komputera.
Nazwa domeny.
Wszystkie komputery z wyjątkiem hostów zarządzanych przez program Virtual Machine Manager (VMM).
Wszystkie komputery z wyjątkiem serwerów bibliotek zarządzanych przez program VMM.
Tylko hosty funkcji Hyper-V.
Komputery bez systemu operacyjnego, które mają kontrolery poza pasmem.

Uwaga: Jeśli dodasz nowy komputer, taki jak host lub serwer biblioteki, znajdujący się w domenie usługi Active Directory do programu VMM, a następnie natychmiast uruchom polecenie cmdlet Discover-Computer , polecenie cmdlet może nie od razu odnaleźć nowego komputera podczas wyszukiwania w usłudze Active Directory. To opóźnienie może wystąpić, ponieważ dane dotyczące nowego komputera mogły nie zostać jeszcze zreplikowane w domenie usługi Active Directory. Jeśli jesteś administratorem domeny, możesz użyć konsoli Lokacje i usługi Active Directory, aby wymusić natychmiastowe replikowanie danych.

Przykłady

Przykład 1. Wyszukiwanie komputerów w określonej domenie spełniającej określone kryteria

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

Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie Konto komputera hosta 01 i przechowuje obiekt w zmiennej $RunAsAccount.

Drugie polecenie wysyła zapytanie do usługi Active Directory i zwraca listę obiektów komputerów funkcji Hyper-V dla komputerów znajdujących się w domenie Contoso.com, które mają nazwę rozpoczynającą się od "hosta" i które nie są zarządzane przez program VMM. Podczas przetwarzania tego polecenia $RunAsAccount dostarcza poświadczenia do aplikacji Find-SCComputer.

Uwaga: w przypadku używania polecenia Find-SCComputer z parametrem Domena należy określić w pełni kwalifikowaną nazwę domeny.

Przykład 2. Wyszukiwanie określonego komputera według nazwy i weryfikowanie jego właściwości w usłudze Active Directory

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

To polecenie używa w pełni kwalifikowanej nazwy domeny (FQDN) komputera o nazwie VMHost01, aby znaleźć ten komputer w usłudze Active Directory, zwraca obiekt komputera i wyświetla właściwości obiektu komputera dla użytkownika.

Przykład 3. Wyszukiwanie wszystkich komputerów w określonej domenie, które nie są serwerem biblioteki programu VMM

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

Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie Konto komputera hosta 01 i przechowuje obiekt w zmiennej $RunAsAccount.

Drugie polecenie wysyła zapytanie do usługi Active Directory dla wszystkich komputerów w domenie Contoso.com, które zawierają "vmm" w nazwie komputera z wyjątkiem serwerów bibliotek programu VMM. Podczas przetwarzania tego polecenia $RunAsAccount dostarcza poświadczenia do aplikacji Find-SCComputer.

Przykład 4. Znajdowanie wszystkich niezarządzanych komputerów w określonej domenie przy użyciu zapytania usługi 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

Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie Konto komputera hosta 01 i przechowuje obiekt w zmiennej $RunAsAccount.

Drugie polecenie wysyła zapytanie do usługi Active Directory dla wszystkich komputerów w domenie Contoso.com, które spełniają kryteria zapytania: dowolny komputer z systemem Windows Server 2008 R2 o nazwie rozpoczynającej się od Test0, ale które nie są serwerami biblioteki programu VMM lub hostami programu VMM. Podczas przetwarzania tego polecenia $RunAsAccount dostarcza poświadczenia do aplikacji Find-SCComputer.

Przykład 5. Znajdowanie komputerów bez systemu operacyjnego z kontrolerami poza pasmem, które znajdują się w określonym zakresie sieci

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

Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie Konto BMC 01 i przechowuje obiekt w zmiennej $BMCRunAsAccount.

Drugie polecenie skanuje sieć dla komputera fizycznego przy użyciu określonego kontrolera BMCAddress. Podczas przetwarzania tego polecenia $BMCRunAsAccount dostarcza poświadczenia do polecenia Find-SCComputer.

Przykład 6. Wykonywanie głębokiego odnajdywania na maszynie fizycznej z obsługą komputerów bez systemu operacyjnego

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

Pierwsze polecenie pobiera obiekt konta Uruchom jako o nazwie Konto BMC 01 i przechowuje obiekt w zmiennej $BMCRunAsAccount.

Trzecie polecenie wykonuje głębokie odnajdywanie na obiekcie komputera i zwraca obiekt maszyny fizycznej do zmiennej $MyComputer 01.

Ostatnie polecenie wyświetla właściwości obiektu komputera przechowywanego w zmiennej $MyComputer 01.

Parametry

-ADSearchFilter

Definiuje zapytanie usługi Active Directory dotyczące odnajdywania. Użyj tego parametru, aby określić zapytanie zawierające informacje o domenie usługi Active Directory i filtry wyszukiwania.

Przykładowy format: -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

Wskazuje, że to polecenie cmdlet pobiera wszystkie obiekty podrzędne niezależnie od obiektu nadrzędnego.

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

-BMCAddress

Określa lub aktualizuje adres kontrolera zarządzania płytą główną poza pasmem (BMC) dla określonej maszyny fizycznej. Może to być adres IP, w pełni kwalifikowana nazwa domeny (FQDN) lub prefiks DNS (który jest zwykle taką samą nazwą jak nazwa NetBIOS).

Zazwyczaj adres BMC i jego połączenie z siecią są oddzielone od adresu IP skojarzonego ze standardową kartą sieciową. Alternatywnie niektóre komputery używają standardowej karty sieciowej w celu zapewnienia jednego adresu kontrolera BMC i karty sieciowej. Jednak adres BMC ma unikatowy port i jest w ten sposób jednoznacznie rozpoznawalny w sieci.

Przykładowy format IPv4: -BMCAddress "10.0.0.21"

Przykładowy format Ipv6: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Przykładowy format nazwy FQDN: -BMCAddress "Computer01.Contoso.com"

Przykładowy format NetBIOS: -BMCAddress "Computer01"

Uwaga: domyślnie program VMM używa adresu IP lub nazwy FQDN dla adresu BMC. Istnieje jednak również możliwość utworzenia modułu programu PowerShell, który umożliwia określenie innych typów adresów jako adresu kontrolera BMC.

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

-BMCCustomConfigurationProvider

Określa lub aktualizuje obiekt dostawcy konfiguracji dla kontrolera zarządzania płytą główną (BMC). Dostawca konfiguracji to wtyczka do programu VMM, która tłumaczy polecenia programu PowerShell programu VMM na wywołania interfejsu API specyficzne dla typu kontrolera zarządzania płytą główną. Ten parametr powinien być używany z niestandardowym BMCProtocol.

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

-BMCPort

Określa lub aktualizuje port kontrolera zarządzania płytą główną poza pasmem (BMC) dla określonej maszyny fizycznej. Port kontrolera BMC jest również nazywany portem procesora usług. Przykładowe domyślne porty to 623 dla protokołu IPMI i 443 dla powłoki SMASH przez program WS-Man.

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

-BMCProtocol

Określa lub aktualizuje protokół używany przez program VMM do komunikowania się z kontrolerem zarządzania płytą główną poza pasmem (BMC). Prawidłowe wartości:

IPMI
SMASH
Niestandardowy

Kontroler BMC (znany również jako procesor usługi lub kontroler zarządzania) jest wyspecjalizowanym kontrolerem na płycie głównej serwera, który działa interfejs między oprogramowaniem do zarządzania sprzętem i systemem. Jeśli płyta główna maszyny fizycznej zawiera kontroler BMC, gdy maszyna jest podłączona (czy jest wyłączona, czy włączona, i czy jest zainstalowany system operacyjny), informacje o sprzęcie systemowym i stanie kondycji sprzętu systemu są dostępne.

Przykładowy format: -BMCProtocol "Custom"

Uwaga: protokół niestandardowy wymaga użycia parametru BMCCustomConfigurationProvider .

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

-BMCRunAsAccount

Określa konto Uruchom jako do użycia z urządzeniem kontrolera zarządzania płytą główną (BMC).

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

-ComputerName

Określa nazwę komputera, który program VMM może jednoznacznie zidentyfikować w sieci. Dopuszczalne wartości dla tego parametru to:

Nazwa FQDN
Adres IPv4 lub IPv6
Nazwa NetBIOS

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

-ComputerNameFilter

Określa częściową lub pełną nazwę komputera, który polecenie cmdlet spróbuje odnaleźć w usłudze Active Directory.

Przykładowy format: -ComputerNameFilter "host"

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

-Credential

Określa obiekt poświadczeń lub, dla niektórych poleceń cmdlet, obiekt konta Uruchom jako, który zawiera nazwę użytkownika i hasło konta, które ma uprawnienia do wykonania tej akcji. Lub w przypadku zadania Restart-SCJob ma uprawnienia do ukończenia ponownie uruchomionego zadania.

Aby uzyskać więcej informacji na temat obiektu PSCredential, wpisz Get-Help Get-Credential.

Aby uzyskać więcej informacji na temat kont Uruchom jako, wpisz Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Wskazuje, że głębokie odnajdywanie jest używane dla określonego komputera.

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

-DiscoveryID

Tylko do użytku wewnętrznego (nie do użycia w kodzie).

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

-Domain

Określa w pełni kwalifikowaną nazwę domeny (FQDN) dla domeny usługi Active Directory.

Przykładowy format: -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

Wyklucza hosty maszyn wirtualnych aktualnie zarządzane przez program VMM.

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

-ExcludeVMMLibrary

Wyklucza serwery bibliotek obecnie zarządzane przez program VMM.

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

-ExcludeVMs

Wyklucza maszyny wirtualne.

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

-FindHyperVHost

Wyszukuje komputery z systemem Windows Server 2008 lub nowszym, na których jest włączona rola serwera funkcji Hyper-V.

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

-IPAddressRangeEnd

Określa ostatni adres IP w zakresie adresów IP. Użyj z parametrem IPAddressRangeStart .

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

-IPAddressRangeStart

Określa pierwszy adres IP w zakresie adresów IP. Użyj z parametrem IPAddressRangeEnd .

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-SMBiosGuid

Określa system BIOS globalnie unikatowy identyfikator (SMBIOS GUID) dla komputera fizycznego, który jest skojarzony z rekordem dla tego komputera fizycznego w programie VMM.

SMBIOS definiuje struktury danych i metody dostępu, które umożliwiają użytkownikowi lub aplikacji przechowywanie i pobieranie informacji o sprzęcie na tym komputerze, takich jak nazwa systemu, producenta lub systemowa wersja systemu BIOS. Systemy operacyjne Windows pobierają dane SMBIOS podczas uruchamiania systemu i udostępniają te dane programom.

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

-Subnet

Określa podsieć IP (IPv4 lub IPv6) w notacji Bezklasowe Inter-Domain Routing (CIDR).

Przykładowy format podsieci IPv4: 192.168.0.1/24

Przykładowy format podsieci IPv6: FD4A:29CD:184F:3A2C::/64

Uwaga: podsieć IP nie może nakładać się na żadną inną podsieć w grupie hostów lub podrzędnych grupach hostów.

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

-VMMServer

Określa obiekt serwera programu VMM.

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

Dane wyjściowe

Computer

To polecenie cmdlet zwraca obiekt Computer .

Get-SCRunAsAccount

Udostępnij za pośrednictwem

Find-SCComputer

Składnia

Opis

Przykłady

Przykład 1. Wyszukiwanie komputerów w określonej domenie spełniającej określone kryteria

Przykład 2. Wyszukiwanie określonego komputera według nazwy i weryfikowanie jego właściwości w usłudze Active Directory

Przykład 3. Wyszukiwanie wszystkich komputerów w określonej domenie, które nie są serwerem biblioteki programu VMM

Przykład 4. Znajdowanie wszystkich niezarządzanych komputerów w określonej domenie przy użyciu zapytania usługi Active Directory

Przykład 5. Znajdowanie komputerów bez systemu operacyjnego z kontrolerami poza pasmem, które znajdują się w określonym zakresie sieci

Przykład 6. Wykonywanie głębokiego odnajdywania na maszynie fizycznej z obsługą komputerów bez systemu operacyjnego

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

Dane wyjściowe

Dodatkowe zasoby

Udostępnij za pośrednictwem

Find-SCComputer

Składnia

Opis

Przykłady

Przykład 1. Wyszukiwanie komputerów w określonej domenie spełniającej określone kryteria

Przykład 2. Wyszukiwanie określonego komputera według nazwy i weryfikowanie jego właściwości w usłudze Active Directory

Przykład 3. Wyszukiwanie wszystkich komputerów w określonej domenie, które nie są serwerem biblioteki programu VMM

Przykład 4. Znajdowanie wszystkich niezarządzanych komputerów w określonej domenie przy użyciu zapytania usługi Active Directory

Przykład 5. Znajdowanie komputerów bez systemu operacyjnego z kontrolerami poza pasmem, które znajdują się w określonym zakresie sieci

Przykład 6. Wykonywanie głębokiego odnajdywania na maszynie fizycznej z obsługą komputerów bez systemu operacyjnego

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

Dane wyjściowe

Linki powiązane

Dodatkowe zasoby