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 hesap 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: Belirli bir bilgisayarı ada göre arama ve Active Directory'deki özelliklerini doğrulama

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

Bu komut, bu bilgisayarı Active Directory'de bulmak, bilgisayar nesnesini döndürmek ve kullanıcıya bilgisayar nesnesi özelliklerini görüntülemek için VMHost01 adlı bilgisayarın tam etki alanı adını (FQDN) kullanır.

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

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 hesap 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 hesap nesnesini alır ve nesneyi $RunAsAccount değişkeninde depolar.

İkinci komut, Contoso.com etki alanındaki sorgu ölçütlerini karşılayan 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ığında bant dışı denetleyicileri olan çı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 Hesabı 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 keşif 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 Hesabı 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 bulma 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 alacağı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ğ üzerinde benzersiz bir şekilde 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 varsayılan olarak BMC Adresi için 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ı bir BMC içeriyorsa, makine prize takılıyken (kapalı veya açık olup olmadığı ve işletim sisteminin yüklü olup olmadığı), sistem donanımı ve sistem donanımının 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

Bu eylemi gerçekleştirme izni olan bir hesabın kullanıcı adını ve parolasını içeren bir kimlik bilgisi nesnesi veya bazı cmdlet'ler için Farklı Çalıştır hesabı nesnesi 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 adresleri 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 hemen komut kabuğuna 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 bu fiziksel bilgisayar için bir kayıtla ilişkilendirilmiş bir fiziksel bilgisayar için Sistem Yönetimi BIOS genel olarak 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, sistem başlangıcında SMBIOS verilerini 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ğı, bir konak grubu veya alt konak grubundaki 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

Aracılığıyla paylaş

Find-SCComputer

Syntax

Description

Örnekler

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

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

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

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

Örnek 5: Belirli bir ağ aralığında bant dışı denetleyicileri olan çıplak bilgisayarları bulma

Örnek 6: Çıplak bilgisayar desteğine sahip bir fiziksel makinede derin keşif 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

Ek kaynaklar

Aracılığıyla paylaş

Find-SCComputer

Syntax

Description

Örnekler

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

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

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

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

Örnek 5: Belirli bir ağ aralığında bant dışı denetleyicileri olan çıplak bilgisayarları bulma

Örnek 6: Çıplak bilgisayar desteğine sahip bir fiziksel makinede derin keşif 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