Find-SCComputer

Başvuru

Modül:: VirtualMachineManager

Active Directory'yi sorgulayarak bilgisayarları arar ve bilgisayar nesnelerini döndürür.

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

Find-SCComputer cmdlet'i, Active Directory'yi sorgulayarak bir veya daha fazla bilgisayar arar ve bilgisayar nesnelerini döndürür.

Bu cmdlet'i, belirtilen ölçütlere veya aşağıdaki ölçütlerin birleşimine göre bilgisayarlar için Active Directory'yi sorgulamak için kullanabilirsiniz:

Bir bilgisayarın tam etki alanı adı (FQDN).
Bilgisayar adının tümü veya bir bölümü.
Etki alanının adı.
Virtual Machine Manager (VMM) tarafından yönetilen konaklar dışındaki tüm bilgisayarlar.
VMM tarafından yönetilen kitaplık sunucuları dışındaki tüm bilgisayarlar.
Yalnızca Hyper-V konakları.
Bant dışı denetleyicileri olan çıplak bilgisayarlar.

Not: VMM'ye Active Directory etki alanında bulunan konak veya kitaplık sunucusu gibi yeni bir bilgisayar ekler ve ardından Bilgisayarı Bul cmdlet'ini hemen çalıştırırsanız, cmdlet Active Directory'de arama yaparken yeni bilgisayarı hemen bulamayabilir. Yeni bilgisayarla ilgili veriler henüz Active Directory etki alanı genelinde çoğaltılmadığından bu gecikme oluşabilir. Etki Alanı Yöneticisiyseniz, verileri hemen çoğaltmaya zorlamak için Active Directory Siteleri ve Hizmetleri konsolunu kullanabilirsiniz.

Örnekler

Örnek 1: Belirli bir etki alanında belirtilen ölçütlere uyan bilgisayarları arama

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

İlk komut, Konak Bilgisayar Hesabı 01 adlı Farklı Çalıştır hesabı nesnesini alır ve nesneyi $RunAsAccount değişkeninde depolar.

İkinci komut Active Directory'yi sorgular ve Contoso.com etki alanında bulunan, adı "konak" ile başlayan ve VMM tarafından yönetilmeyen bilgisayarlar için Hyper-V bilgisayar nesnelerinin listesini döndürür. Bu komut işlenirken, $RunAsAccount Find-SCComputer için kimlik bilgileri sağlar.

Not: Etki Alanı parametresiyle Find-SCComputer kullandığınızda, tam etki alanı adını belirtmeniz gerekir.

Örnek 2: Active Directory'de belirli bir bilgisayarı ada göre arama ve özelliklerini doğrulama

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

Bu komut, VMHost01 adlı bilgisayarın tam etki alanı adını (FQDN) kullanarak bu bilgisayarı Active Directory'de bulur, bilgisayar nesnesini döndürür ve kullanıcıya bilgisayar nesnesi özelliklerini görüntüler.

Örnek 3: Belirtilen etki alanında VMM kitaplık sunucusu olmayan tüm bilgisayarları arayın

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

İlk komut, Konak Bilgisayar Hesabı 01 adlı Farklı Çalıştır hesabı nesnesini alır ve nesneyi $RunAsAccount değişkeninde depolar.

İkinci komut, Contoso.com etki alanındaki VMM kitaplık sunucuları dışında bilgisayar adında "vmm" bulunan tüm bilgisayarlar için Active Directory'yi sorgular. Bu komut işlenirken, $RunAsAccount Find-SCComputer için kimlik bilgileri sağlar.

Örnek 4: Active Directory sorgusu kullanarak belirtilen etki alanındaki tüm yönetilmeyen bilgisayarları bulma

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

İlk komut, Konak Bilgisayar Hesabı 01 adlı Farklı Çalıştır hesabı nesnesini alır ve nesneyi $RunAsAccount değişkeninde depolar.

İkinci komut, sorgu ölçütlerini karşılayan Contoso.com etki alanındaki tüm bilgisayarlar için Active Directory'yi sorgular: Test0 ile başlayan ancak VMM kitaplık sunucuları veya VMM konakları olmayan bir ada sahip herhangi bir Windows Server 2008 R2 bilgisayarı. Bu komut işlenirken, $RunAsAccount Find-SCComputer için kimlik bilgileri sağlar.

Örnek 5: Belirli bir ağ aralığındaki bant dışı denetleyicilere sahip çıplak bilgisayarları bulma

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

İlk komut BMC Account 01 adlı Farklı Çalıştır hesabı nesnesini alır ve nesneyi $BMCRunAsAccount değişkeninde depolar.

İkinci komut, belirtilen BMCAddress değerine sahip bir fiziksel bilgisayar için ağı tarar. Bu komut işlenirken, $BMCRunAsAccount Find-SCComputer için kimlik bilgileri sağlar.

Örnek 6: Çıplak bilgisayar desteğine sahip bir fiziksel makinede derin bulma gerçekleştirme

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

İlk komut BMC Account 01 adlı Farklı Çalıştır hesabı nesnesini alır ve nesneyi $BMCRunAsAccount değişkeninde depolar.

İkinci komut, belirtilen BMCAddress değerine sahip bir fiziksel bilgisayar için ağı tarar. Bu komut işlenirken, $BMCRunAsAccount Find-SCComputer için kimlik bilgileri sağlar.

Üçüncü komut, bilgisayar nesnesinde derin bulmayı gerçekleştirir ve fiziksel makine nesnesini $MyComputer 01 değişkenine döndürür.

Son komut, $MyComputer 01 değişkeninde depolanan bilgisayar nesnesinin özelliklerini görüntüler.

Parametreler

-ADSearchFilter

Bulma için bir Active Directory sorgusu tanımlar. Active Directory etki alanı bilgilerini ve arama filtrelerini içeren bir sorgu belirtmek için bu parametreyi kullanın.

Örnek biçim: -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

Bu cmdlet'in tüm alt nesneleri üst nesneden bağımsız olarak aldığını gösterir.

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

-BMCAddress

Belirli bir fiziksel makine için bant dışı temel kart yönetim denetleyicisi (BMC) adresini belirtir veya güncelleştirir. Bu bir IP adresi, tam etki alanı adı (FQDN) veya DNS ön eki (genellikle NetBIOS adıyla aynı addır) olabilir.

Genellikle BMC adresi ve ağ bağlantısı, standart bir ağ bağdaştırıcısıyla ilişkili IP adresinden ayrıdır. Alternatif olarak, bazı bilgisayarlar BMC ve ağ bağdaştırıcısı için tek bir adres sağlamak üzere standart bir ağ bağdaştırıcısı kullanır. Ancak BMC adresinin benzersiz bir bağlantı noktası vardır ve bu nedenle ağda benzersiz olarak tanımlanabilir.

Örnek IPv4 biçimi: -BMCAddress "10.0.0.21"

Örnek Ipv6 biçimi: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Örnek FQDN biçimi: -BMCAddress "Computer01.Contoso.com"

Örnek NetBIOS biçimi: -BMCAddress "Computer01"

Not: VMM, BMC Adresi için varsayılan olarak bir IP adresi veya FQDN kullanır. Ancak, BMC adresi olarak diğer adres türlerini belirtmenize olanak tanıyan bir PowerShell modülü oluşturmak da mümkündür.

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

-BMCCustomConfigurationProvider

Bir temel kart yönetim denetleyicisi (BMC) için yapılandırma sağlayıcısı nesnesini belirtir veya güncelleştirir. Yapılandırma sağlayıcısı, VMM PowerShell komutlarını bir tür temel kart yönetim denetleyicisine özgü API çağrılarına çeviren bir VMM eklentisidir. Bu parametre Özel BMCProtocol ile kullanılmalıdır.

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

-BMCPort

Belirli bir fiziksel makine için bant dışı temel kart yönetim denetleyicisi (BMC) bağlantı noktasını belirtir veya güncelleştirir. BMC bağlantı noktası, hizmet işlemcisi bağlantı noktası olarak da bilinir. Örnek varsayılan bağlantı noktaları IPMI için 623 ve WS-Man üzerinden SMASH için 443'tir.

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

-BMCProtocol

VMM'nin bant dışı temel kart yönetim denetleyicisi (BMC) ile iletişim kurmak için kullandığı protokolü belirtir veya güncelleştirir. Geçerli değerler:

IPMI
ŞUT
Özel

BMC (hizmet işlemcisi veya yönetim denetleyicisi olarak da bilinir), donanım ve sistem yönetim yazılımı arasında bir arabirim işlevi gören bir sunucunun ana kartında özel bir denetleyicidir. Fiziksel bir makinenin ana kartında BMC varsa, makine prize takılıyken (kapalı veya açık olup olmadığı ve bir işletim sisteminin yüklü olup olmadığı), sistem donanımı ve bu sistem donanım durumunun durumu hakkında bilgi sağlanır.

Örnek biçim: -BMCProtocol "Custom"

Not: Özel protokol , BMCCustomConfigurationProvider parametresini kullanmanızı gerektirir.

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

-BMCRunAsAccount

Temel kart yönetim denetleyicisi (BMC) cihazıyla kullanılacak Farklı Çalıştır hesabını belirtir.

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

-ComputerName

VMM'nin ağınızda benzersiz olarak tanımlayabildiği bir bilgisayarın adını belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

FQDN
IPv4 veya IPv6 adresi
NetBIOS adı

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

-ComputerNameFilter

Cmdlet'in Active Directory'de bulmaya çalışacağı bilgisayarın kısmi veya tam adını belirtir.

Örnek biçim: -ComputerNameFilter "host"

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

-Credential

Kimlik bilgisi nesnesini veya bazı cmdlet'ler için, bu eylemi gerçekleştirme izni olan bir hesabın kullanıcı adını ve parolasını içeren farklı çalıştır hesabı nesnesini belirtir. Veya Restart-SCJob durumunda, yeniden başlatılan bir görevi tamamlama izni vardır.

PSCredential nesnesi hakkında daha fazla bilgi için yazın Get-Help Get-Credential.

Farklı Çalıştır hesapları hakkında daha fazla bilgi için yazın Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Belirtilen bilgisayar için derin bulmanın kullanıldığını gösterir.

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

-DiscoveryID

Yalnızca iç kullanım için (kodunuzda kullanım için değil).

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

-Domain

Active Directory etki alanı için tam etki alanı adını (FQDN) belirtir.

Örnek biçim: -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

ŞU anda VMM tarafından yönetilen sanal makine konaklarını dışlar.

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

-ExcludeVMMLibrary

ŞU anda VMM tarafından yönetilen kitaplık sunucularını dışlar.

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

-ExcludeVMs

Sanal makineleri dışlar.

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

-FindHyperVHost

Hyper-V sunucu rolünün etkinleştirildiği Windows Server 2008 veya üzerini çalıştıran bilgisayarları arar.

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

-IPAddressRangeEnd

Bir IP adresi aralığındaki son IP adresini belirtir. IPAddressRangeStart parametresiyle kullanın.

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

-IPAddressRangeStart

Bir IP adresi aralığındaki ilk IP adresini belirtir. IPAddressRangeEnd parametresiyle kullanın.

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

-JobVariable

İş ilerleme durumunun izlendiğini ve bu parametre tarafından adlandırılan değişkende depolandığını belirtir.

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

-RunAsynchronously

Denetimin komut kabuğuna hemen döndürülmesi için işin zaman uyumsuz olarak çalıştığını gösterir.

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

-SMBiosGuid

VMM'de söz konusu fiziksel bilgisayar için bir kayıtla ilişkilendirilmiş bir fiziksel bilgisayar için Sistem Yönetimi BIOS genel benzersiz tanımlayıcısını (SMBIOS GUID) belirtir.

SMBIOS, bir kullanıcının veya uygulamanın bu bilgisayardaki donanım hakkında sistem adı, üretici veya sistem BIOS sürümü gibi bilgileri depolamasını ve almasını sağlayan veri yapılarını ve erişim yöntemlerini tanımlar. Windows işletim sistemleri SMBIOS verilerini sistem başlangıcında alır ve bu verileri programlar için kullanılabilir hale getirir.

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

-Subnet

Sınıfsız Inter-Domain Yönlendirme (CIDR) gösteriminde bir IP alt ağı (IPv4 veya IPv6) belirtir.

IPv4 alt ağı için örnek biçim: 192.168.0.1/24

IPv6 alt ağı için örnek biçim: FD4A:29CD:184F:3A2C::/64

Not: IP alt ağı, konak grubundaki veya alt konak gruplarındaki diğer alt ağlarla çakışamaz.

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

-VMMServer

Bir VMM sunucu nesnesi belirtir.

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

Çıkışlar

Computer

Bu cmdlet bir Bilgisayar nesnesi döndürür.

Get-SCRunAsAccount

Find-SCComputer

Syntax

Description

Örnekler

Örnek 1: Belirli bir etki alanında belirtilen ölçütlere uyan bilgisayarları arama

Örnek 2: Active Directory'de belirli bir bilgisayarı ada göre arama ve özelliklerini doğrulama

Örnek 3: Belirtilen etki alanında VMM kitaplık sunucusu olmayan tüm bilgisayarları arayın

Örnek 4: Active Directory sorgusu kullanarak belirtilen etki alanındaki tüm yönetilmeyen bilgisayarları bulma

Örnek 5: Belirli bir ağ aralığındaki bant dışı denetleyicilere sahip çıplak bilgisayarları bulma

Örnek 6: Çıplak bilgisayar desteğine sahip bir fiziksel makinede derin bulma gerçekleştirme

Parametreler

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Çıkışlar

İlişkili Bağlantılar

Ek kaynaklar