Find-SCComputer

參考

模組:: VirtualMachineManager

查詢 Active Directory 來搜尋電腦，並傳回電腦物件。

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 會藉由查詢 Active Directory 來搜尋一或多部電腦，並傳回電腦物件。

您可使用此指令程式依據指定的條件或條件組合來查詢 Active Directory 中的電腦，包括：

電腦 (FQDN) 的完整功能變數名稱。
所有或部分的電腦名稱稱。
網域的名稱。
Virtual Machine Manager 所管理主機以外的所有電腦 (VMM) 。
VMM 所管理程式庫伺服器以外的所有電腦。
只有 Hyper-V 主機。
具有頻外控制器的裸機電腦。

注意：如果您將位於 Active Directory 網域中的主機或程式庫伺服器之類的新電腦新增至 VMM，然後立即執行 Discover-Computer Cmdlet，Cmdlet 可能不會在搜尋 Active Directory 時立即探索新電腦。可能會發生此延遲，因為新電腦的相關資料可能尚未複寫到 Active Directory 網域。若您是網域系統管理員，可以使用 [Active Directory 站台及服務] 主控台立即強制複寫資料。

範例

範例 1：搜尋特定網域中符合指定準則的電腦

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

第一個命令會取得名為主電腦帳戶 01 的執行身分帳戶物件，並將物件儲存在$RunAsAccount變數中。

第二個命令會查詢 Active Directory，並傳回位於 Contoso.com 網域、名稱開頭為 "host" 且不是由 VMM 管理之電腦的 Hyper-V 電腦物件清單。處理此命令時，$RunAsAccount提供 Find-SCComputer的認證。

注意：當您搭配 Domain參數使用Find-SCComputer時，您必須指定完整功能變數名稱。

範例 2：依名稱搜尋特定電腦，並在 Active Directory 中驗證其屬性

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

此命令會使用名為 VMHost01 之電腦的完整功能變數名稱 (FQDN) ，在 Active Directory 中尋找這部電腦、傳回電腦物件，並將電腦物件屬性顯示給使用者。

範例 3：搜尋指定網域中不是 VMM 程式庫伺服器的所有電腦

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

第一個命令會取得名為主電腦帳戶 01 的執行身分帳戶物件，並將物件儲存在$RunAsAccount變數中。

第二個命令會查詢 Active Directory，以取得 Contoso.com 網域中包含「vmm」的電腦名稱稱，但 VMM 程式庫伺服器除外。處理此命令時，$RunAsAccount提供 Find-SCComputer的認證。

範例 4：使用 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

第一個命令會取得名為主電腦帳戶 01 的執行身分帳戶物件，並將物件儲存在$RunAsAccount變數中。

第二個命令會查詢符合查詢準則之 Contoso.com 網域中所有電腦的 Active Directory：任何名稱開頭為 Test0 但不是 VMM 程式庫伺服器或 VMM 主機的 Windows Server 2008 R2 電腦。處理此命令時，$RunAsAccount提供 Find-SCComputer的認證。

範例 5：尋找在特定網路範圍內具有頻外控制器的裸機電腦

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

第一個命令會取得名為 BMC 帳戶 01 的執行身分帳戶物件，並將物件儲存在$BMCRunAsAccount變數中。

第二個命令會掃描網路是否有具有指定 BMCAddress 的實體電腦。處理此命令時，$BMCRunAsAccount提供 Find-SCComputer的認證。

範例 6：在具有裸機電腦支援的實體電腦上執行深入探索

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

第一個命令會取得名為 BMC 帳戶 01 的執行身分帳戶物件，並將物件儲存在$BMCRunAsAccount變數中。

第二個命令會掃描網路是否有具有指定 BMCAddress 的實體電腦。處理此命令時，$BMCRunAsAccount提供 Find-SCComputer的認證。

第三個命令會在電腦物件上執行深層探索，並將實體電腦物件傳回至 $MyComputer 01 變數。

最後一個命令會顯示儲存在 $MyComputer 01 變數中的電腦物件屬性。

參數

-ADSearchFilter

定義用於探索的 Active Directory 查詢。使用此參數來指定包含 Active Directory 網域資訊和搜尋篩選準則的查詢。

範例格式： -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

表示這個 Cmdlet 會取得與父物件無關的所有次級物件。

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

-BMCAddress

指定或更新特定實體電腦的頻外基礎板管理控制器 (BMC) 位址。這可能是 IP 位址、FQDN) (完整功能變數名稱，或 DNS 前置詞 (，這通常與 NetBIOS 名稱) 的名稱相同。

一般而言，BMC 位址及其與網路連線會與標準網路介面卡相關聯的 IP 位址分開。或者，有些電腦會使用標準網路介面卡來提供 BMC 和網路介面卡的單一位址。不過，BMC 位址具有唯一的埠，因此可在網路上唯一識別。

範例 IPv4 格式： -BMCAddress "10.0.0.21"

範例 Ipv6 格式： -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

範例 FQDN 格式： -BMCAddress "Computer01.Contoso.com"

NetBIOS 格式範例： -BMCAddress "Computer01"

注意：根據預設，VMM 會針對 BMC 位址使用 IP 位址或 FQDN。不過，您也可以建立 PowerShell 模組，讓您將其他類型的位址指定為 BMC 位址。

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

-BMCCustomConfigurationProvider

指定或更新 BMC) 基礎板管理控制器的組態提供者物件 (。組態提供者是 VMM 的外掛程式，可將 VMM PowerShell 命令轉譯為特定基板管理控制器類型的 API 呼叫。此參數應該與自訂 BMCProtocol 搭配使用。

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

-BMCPort

指定或更新特定實體電腦的頻外基礎板管理控制器 (BMC) 埠。 BMC 埠也稱為服務處理器埠。 IPMI 的預設埠範例為 623，而透過 WS-Man 的 SMASH 則為 443。

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

-BMCProtocol

指定或更新 VMM 用來與頻外基礎板管理控制器通訊的通訊協定， (BMC) 。有效值為：

IPMI
粉碎
Custom

BMC (也稱為服務處理器或管理控制器) 是伺服器主機板上的特製化控制器，可作用硬體與系統管理軟體之間的介面。如果實體機器的主機板包含 BMC，當機器插入電源 (是否已關閉或開啟電源，以及是否已安裝作業系統) 、系統硬體的相關資訊以及該系統硬體健康情況的狀態可用時。

範例格式： -BMCProtocol "Custom"

注意：自訂通訊協定要求您使用 BMCCustomConfigurationProvider 參數。

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

-BMCRunAsAccount

指定要與 BMC) 裝置 (基礎板管理控制器搭配使用的執行身分帳戶。

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

-ComputerName

指定 VMM 可在您的網路中唯一識別的電腦名稱。此參數可接受的值為：

FQDN
IPv4 或 IPv6 位址
NetBIOS 名稱

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

-ComputerNameFilter

指定指令程式將嘗試在 Active Directory 中探索之電腦的部分或完整名稱。

範例格式： -ComputerNameFilter "host"

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

-Credential

指定認證物件，或針對某些 Cmdlet 指定執行身分帳戶物件，其中包含有權執行此動作之帳戶的使用者名稱和密碼。或者，如果是 Restart-SCJob，則有權完成重新開機的工作。

如需 PSCredential 物件的詳細資訊，請輸入 Get-Help Get-Credential 。

如需執行身分帳戶的詳細資訊，請輸入 Get-Help New-SCRunAsAccount 。

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

-DeepDiscovery

表示已針對指定的電腦使用深層探索。

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

-DiscoveryID

僅供內部使用 (不適用您的程式碼)。

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

-Domain

指定 Active Directory 網域的完整網域名稱 (FQDN)。

範例格式： -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

排除 VMM 目前管理的虛擬機器主機。

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

-ExcludeVMMLibrary

排除 VMM 目前管理的程式庫伺服器。

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

-ExcludeVMs

排除虛擬機器。

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

-FindHyperVHost

搜尋執行 Windows Server 2008 或更新版本且已啟用 Hyper-V 伺服器角色的電腦。

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

-IPAddressRangeEnd

指定 IP 位址範圍中的最後一個 IP 位址。搭配 IPAddressRangeStart 參數使用。

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

-IPAddressRangeStart

指定 IP 位址範圍中的第一個 IP 位址。搭配 IPAddressRangeEnd 參數使用。

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

-JobVariable

指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。

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

-RunAsynchronously

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

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

-SMBiosGuid

針對與 VMM 中該實體電腦之記錄相關聯的實體電腦，指定 SMBIOS GUID (SMBIOS GUID) 系統管理 BIOS 全域唯一識別碼。

SMBIOS 會定義資料結構和存取方法，讓使用者或應用程式能夠儲存及擷取這部電腦上硬體的相關資訊，例如系統名稱、製造商或系統 BIOS 版本。 Windows 作業系統會在系統啟動時擷取 SMBIOS 資料，並將該資料提供給程式使用。

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

-Subnet

指定 Inter-Domain無類別路由 (CIDR) 標記法中的 IP 子網 (IPv4 或 IPv6) 。

IPv4 子網的範例格式： 192.168.0.1/24

IPv6 子網的範例格式： FD4A:29CD:184F:3A2C::/64

注意：IP 子網不能與主機群組或子主機群組中的其他任何子網重迭。

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

-VMMServer

指定 VMM 伺服器物件。

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

輸出

Computer

這個 Cmdlet 會傳回 Computer 物件。

Get-SCRunAsAccount

共用方式為

Find-SCComputer

Syntax

Description

範例

範例 1：搜尋特定網域中符合指定準則的電腦

範例 2：依名稱搜尋特定電腦，並在 Active Directory 中驗證其屬性

範例 3：搜尋指定網域中不是 VMM 程式庫伺服器的所有電腦

範例 4：使用 Active Directory 查詢尋找指定網域中的所有非受控電腦

範例 5：尋找在特定網路範圍內具有頻外控制器的裸機電腦

範例 6：在具有裸機電腦支援的實體電腦上執行深入探索

參數

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

輸出

其他資源

共用方式為

Find-SCComputer

Syntax

Description

範例

範例 1：搜尋特定網域中符合指定準則的電腦

範例 2：依名稱搜尋特定電腦，並在 Active Directory 中驗證其屬性

範例 3：搜尋指定網域中不是 VMM 程式庫伺服器的所有電腦

範例 4：使用 Active Directory 查詢尋找指定網域中的所有非受控電腦

範例 5：尋找在特定網路範圍內具有頻外控制器的裸機電腦

範例 6：在具有裸機電腦支援的實體電腦上執行深入探索

參數

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

輸出

相關連結

其他資源