Find-SCComputer

Referência

Módulo:: VirtualMachineManager

Procura por computador consultando o Ative Directory e devolve os objetos do computador.

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

O cmdlet Find-SCComputer procura um ou mais computadores consultando o Ative Directory e devolve os objetos do computador.

Pode utilizar este cmdlet para consultar o Ative Directory para computadores com base em critérios especificados, ou uma combinação de critérios, incluindo:

O nome de domínio totalmente qualificado (FQDN) de um computador.
Tudo ou parte do nome do computador.
O nome de um domínio.
Todos os computadores, exceto os anfitriões geridos pelo Virtual Machine Manager (VMM).
Todos os computadores, exceto servidores de biblioteca geridos por VMM.
Só hospedeiros Hiper-V.
Computadores de metal nu que têm controladores fora de banda.

Nota: Se adicionar um novo computador, como um servidor de anfitrião ou biblioteca, localizado num domínio de Diretório Ativo ao VMM e, em seguida, executar imediatamente o cmdlet Discover-Computer , o cmdlet pode não descobrir imediatamente o novo computador quando pesquisar Ative Directory. Este atraso pode ocorrer porque os dados sobre o novo computador podem ainda não ter sido replicados em todo o domínio do Ative Directory. Se for administrador de domínio, pode utilizar a consola Ative Directory Sites and Services para forçar a replicação imediata dos dados.

Exemplos

Exemplo 1: Procurar computadores num domínio específico que satisfaça os critérios especificados

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

O primeiro comando obtém o objeto de conta Run As chamado Host Computer Account 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Ative Directory e devolve uma lista de objetos de computador Hiper-V para computadores localizados no domínio Contoso.com, que têm um nome a começar por "host", e que não são geridos por VMM. Como este comando é processado, $RunAsAccount fornece credenciais ao Find-SCComputer.

Nota: Quando utilizar o Find-SCComputer com o parâmetro Domínio , tem de especificar o nome de domínio totalmente qualificado.

Exemplo 2: Procurar um computador específico pelo nome e validar as suas propriedades no Ative Directory

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

Este comando utiliza o nome de domínio totalmente qualificado (FQDN) do computador chamado VMHost01 para encontrar este computador no Ative Directory, devolve o objeto do computador e exibe as propriedades do objeto do computador ao utilizador.

Exemplo 3: Procurar por todos os computadores do domínio especificado que não sejam um servidor de biblioteca VMM

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

O primeiro comando obtém o objeto de conta Run As chamado Host Computer Account 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Ative Directory para todos os computadores do domínio Contoso.com que incluem "vmm" no nome do computador, exceto nos servidores da biblioteca VMM. Como este comando é processado, $RunAsAccount fornece credenciais ao Find-SCComputer.

Exemplo 4: Encontre todos os computadores não geridos no domínio especificado utilizando uma consulta de Diretório Ativo

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

O primeiro comando obtém o objeto de conta Run As chamado Host Computer Account 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Ative Directory para todos os computadores do domínio Contoso.com que satisfaçam os critérios de consulta: qualquer computador R2 do Windows Server 2008 com um nome que comece com Test0 mas que não sejam servidores de bibliotecas VMM ou anfitriões VMM. Como este comando é processado, $RunAsAccount fornece credenciais ao Find-SCComputer.

Exemplo 5: Encontre computadores de metal nu que tenham controladores fora de banda que estejam dentro de uma gama de rede específica

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

O primeiro comando obtém o objeto de conta Run As chamado BMC Account 01 e armazena o objeto na variável $BMCRunAsAccount.

O segundo comando verifica a rede para um computador físico com o BMCAddress especificado. Como este comando é processado, $BMCRunAsAccount fornece credenciais ao Find-SCComputer.

Exemplo 6: Realizar uma descoberta profunda numa máquina física com suporte a computador de metal nu

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

O primeiro comando obtém o objeto de conta Run As chamado BMC Account 01 e armazena o objeto na variável $BMCRunAsAccount.

O segundo comando verifica a rede para um computador físico com o BMCAddress especificado. Como este comando é processado, $BMCRunAsAccount fornece credenciais ao Find-SCComputer.

O terceiro comando executa a descoberta profunda no objeto do computador e devolve o objeto da máquina física à variável $MyComputer 01.

O último comando mostra as propriedades do objeto do computador armazenado na variável $MyComputer 01.

Parâmetros

-ADSearchFilter

Define uma consulta de Diretório Ativo para a descoberta. Utilize este parâmetro para especificar uma consulta que contenha informações de domínio do Diretório Ativo e filtros de pesquisa.

Formato de exemplo: -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

Indica que este cmdlet obtém todos os objetos subordinados independentemente do objeto principal.

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

-BMCAddress

Especifica, ou atualizações, o endereço do controlador de gestão de base (BMC) fora da banda para uma máquina física específica. Este pode ser um endereço IP, o nome de domínio totalmente qualificado (FQDN), ou o prefixo DNS (que normalmente é o mesmo nome do nome NetBIOS).

Normalmente, o endereço BMC e a sua ligação à rede são separados do endereço IP associado a um adaptador de rede padrão. Em alternativa, alguns computadores utilizam um adaptador de rede padrão para fornecer um único endereço para o BMC e para o adaptador de rede. No entanto, o endereço BMC tem uma porta única e é, portanto, unicamente identificável na rede.

Exemplo IPv4 formato: -BMCAddress "10.0.0.21"

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

Exemplo FQDN formato: -BMCAddress "Computer01.Contoso.com"

Exemplo NetBIOS formato: -BMCAddress "Computer01"

Nota: Por predefinição, a VMM utiliza um endereço IP ou FQDN para o Endereço BMC. No entanto, também é possível criar um módulo PowerShell que lhe permita especificar outros tipos de endereços como endereço BMC.

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

-BMCCustomConfigurationProvider

Especifica, ou atualizações, um objeto de fornecedor de configuração para um controlador de gestão de rodapé (BMC). Um fornecedor de configuração é um plug-in para VMM que traduz comandos VMM PowerShell para chamadas API que são específicas de um tipo de controlador de gestão de rodapé. Este parâmetro deve ser utilizado com o BMCProtocol personalizado.

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

-BMCPort

Especifica, ou atualizações, a porta de gestão de base (BMC) fora da banda para uma máquina física específica. Uma porta BMC também é conhecida como uma porta de processador de serviço. As portas por exemplo são 623 para IPMI e 443 para SMASH over WS-Man.

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

-BMCProtocol

Especifica, ou atualizações, o protocolo que o VMM utiliza para comunicar com o controlador de gestão de base fora de banda (BMC). Os valores válidos são:

IPMI
SMASH
Personalizado

Um BMC (também conhecido como processador de serviço ou controlador de gestão) é um controlador especializado na placa-mãe de um servidor que age uma interface entre o software de gestão de hardware e sistema. Se a placa-mãe de uma máquina física incluir um BMC, quando a máquina está ligada (se está ligada ou ligada, e se um sistema operativo está ou não instalado), estão disponíveis informações sobre hardware do sistema e sobre o estado da saúde do hardware do sistema.

Formato de exemplo: -BMCProtocol "Custom"

Nota: O protocolo Personalizado requer que utilize o parâmetro BMCCustomConfigurationProvider .

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

-BMCRunAsAccount

Especifica a conta Run As para utilizar com o dispositivo de gestão de rodapé (BMC).

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

-ComputerName

Especifica o nome de um computador que o VMM pode identificar exclusivamente na sua rede. Os valores aceitáveis para este parâmetro são:

FQDN
Endereço IPv4 ou IPv6
Nome NetBIOS

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

-ComputerNameFilter

Especifica o nome parcial ou completo de um computador que o cmdlet tentará descobrir no Ative Directory.

Formato de exemplo: -ComputerNameFilter "host"

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

-Credential

Especifica um objeto credencial ou, para alguns cmdlets, um objeto de conta Run As que contém o nome de utilizador e a palavra-passe de uma conta que tem permissão para realizar esta ação. Ou, no caso do Restart-SCJob, tem permissão para completar uma tarefa reiniciada.

Para mais informações sobre o objeto PSCredential, escreva Get-Help Get-Credential.

Para mais informações sobre Run As accounts, escreva Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Indica que a descoberta profunda é usada para o computador especificado.

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

-DiscoveryID

Apenas para utilização interna (não para utilização no seu código).

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

-Domain

Especifica um nome de domínio totalmente qualificado (FQDN) para um domínio ative directory.

Formato de exemplo: -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

Exclui os anfitriões de máquinas virtuais atualmente geridos por VMM.

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

-ExcludeVMMLibrary

Exclui os servidores da biblioteca atualmente geridos por VMM.

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

-ExcludeVMs

Exclui máquinas virtuais.

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

-FindHyperVHost

Procura por computadores que executam o Windows Server 2008 ou posteriormente no qual a função do servidor Hyper-V está ativada.

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

-IPAddressRangeEnd

Especifica o último endereço IP numa série de endereços IP. Utilizar com o parâmetro IPAddressRangeStart .

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

-IPAddressRangeStart

Especifica o primeiro endereço IP numa série de endereços IP. Utilizar com o parâmetro IPAddressRangeEnd .

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

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este parâmetro.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-SMBiosGuid

Especifica o identificador globalmente único de Gestão de Sistemas BIOS (SMBIOS GUID) para um computador físico que está associado a um registo para aquele computador físico em VMM.

O SMBIOS define estruturas de dados e métodos de acesso que permitem ao utilizador ou aplicação armazenar e recuperar informações sobre hardware neste computador, como o nome do sistema, fabricante ou versão BIOS do sistema. Os sistemas operativos Windows recuperam os dados do SMBIOS no arranque do sistema e disponibilizam esses dados aos programas.

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

-Subnet

Especifica uma sub-rede IP (IPv4 ou IPv6) na notação de encaminhamento de Inter-Domain sem classe (CIDR).

Formato de exemplo para uma sub-rede IPv4: 192.168.0.1/24

Formato de exemplo para uma sub-rede IPv6: FD4A:29CD:184F:3A2C::/64

Nota: Uma sub-rede IP não pode sobrepor-se a qualquer outra sub-rede num grupo de acolhimento ou grupos de acolhimento de crianças.

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

-VMMServer

Especifica um objeto de servidor VMM.

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

Saídas

Computer

Este cmdlet devolve um objeto de Computador .

Get-SCRunAsAccount

Partilhar via

Find-SCComputer

Syntax

Description

Exemplos

Exemplo 1: Procurar computadores num domínio específico que satisfaça os critérios especificados

Exemplo 2: Procurar um computador específico pelo nome e validar as suas propriedades no Ative Directory

Exemplo 3: Procurar por todos os computadores do domínio especificado que não sejam um servidor de biblioteca VMM

Exemplo 4: Encontre todos os computadores não geridos no domínio especificado utilizando uma consulta de Diretório Ativo

Exemplo 5: Encontre computadores de metal nu que tenham controladores fora de banda que estejam dentro de uma gama de rede específica

Exemplo 6: Realizar uma descoberta profunda numa máquina física com suporte a computador de metal nu

Parâmetros

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Saídas

Recursos adicionais

Partilhar via

Find-SCComputer

Syntax

Description

Exemplos

Exemplo 1: Procurar computadores num domínio específico que satisfaça os critérios especificados

Exemplo 2: Procurar um computador específico pelo nome e validar as suas propriedades no Ative Directory

Exemplo 3: Procurar por todos os computadores do domínio especificado que não sejam um servidor de biblioteca VMM

Exemplo 4: Encontre todos os computadores não geridos no domínio especificado utilizando uma consulta de Diretório Ativo

Exemplo 5: Encontre computadores de metal nu que tenham controladores fora de banda que estejam dentro de uma gama de rede específica

Exemplo 6: Realizar uma descoberta profunda numa máquina física com suporte a computador de metal nu

Parâmetros

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Saídas

Ligações Relacionadas

Recursos adicionais