Find-SCComputer

Referência

Módulo:: VirtualMachineManager

Pesquisa computadores consultando o Active Directory e retorna 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 Active Directory e retorna os objetos do computador.

Você pode usar esse cmdlet para consultar o Active Directory para computadores com base em critérios especificados ou em uma combinação de critérios, incluindo:

O FQDN (nome de domínio totalmente qualificado) de um computador.
Tudo ou parte do nome do computador.
O nome de um domínio.
Todos os computadores, exceto hosts gerenciados pelo VMM (Virtual Machine Manager).
Todos os computadores, exceto servidores de biblioteca gerenciados pelo VMM.
Somente hosts Hyper-V.
Computadores bare-metal que têm controladores fora de banda.

Observação: se você adicionar um novo computador, como um host ou servidor de biblioteca, localizado em um domínio do Active Directory ao VMM e, em seguida, executar imediatamente o cmdlet Discover-Computer , o cmdlet poderá não descobrir imediatamente o novo computador quando ele pesquisa o Active Directory. Esse atraso pode ocorrer porque os dados sobre o novo computador talvez ainda não tenham sido replicados no domínio do Active Directory. Se você for um Administrador de Domínio, poderá usar o console de Sites e Serviços do Active Directory para forçar a replicação imediata dos dados.

Exemplos

Exemplo 1: pesquisar computadores em um domínio específico que atenda aos 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 Executar como chamado Conta de Computador host 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Active Directory e retorna uma lista de objetos de computador Hyper-V para computadores localizados no domínio Contoso.com, que têm um nome começando com "host" e que não são gerenciados pelo VMM. Como esse comando é processado, $RunAsAccount fornece credenciais para Find-SCComputer.

Observação: ao usar Find-SCComputer com o parâmetro Domínio , você deve especificar o nome de domínio totalmente qualificado.

Exemplo 2: pesquisar um computador específico por nome e validar suas propriedades no Active Directory

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

Esse comando usa o FQDN (nome de domínio totalmente qualificado) do computador chamado VMHost01 para localizar esse computador no Active Directory, retorna o objeto do computador e exibe as propriedades do objeto do computador para o usuário.

Exemplo 3: pesquisar todos os computadores no domínio especificado que não são um servidor de biblioteca do 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 Executar como chamado Conta de Computador host 01 e armazena o objeto na variável $RunAsAccount.

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

Exemplo 4: localizar todos os computadores não gerenciados no domínio especificado usando uma consulta do 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

O primeiro comando obtém o objeto de conta Executar como chamado Conta de Computador host 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Active Directory para todos os computadores no domínio Contoso.com que atendam aos critérios de consulta: qualquer computador Windows Server 2008 R2 com um nome que começa com Test0, mas que não são servidores de biblioteca do VMM ou hosts do VMM. Como esse comando é processado, $RunAsAccount fornece credenciais para Find-SCComputer.

Exemplo 5: localizar computadores bare-metal que têm controladores fora de banda que estão dentro de um intervalo de rede específico

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 Executar como chamado BMC Account 01 e armazena o objeto na variável $BMCRunAsAccount.

O segundo comando examina a rede em busca de um computador físico com o BMCAddress especificado. Como esse comando é processado, $BMCRunAsAccount fornece credenciais para Find-SCComputer.

Exemplo 6: Executar descoberta profunda em um computador físico com suporte a computador bare-metal

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 Executar como chamado BMC Account 01 e armazena o objeto na variável $BMCRunAsAccount.

O segundo comando examina a rede em busca de um computador físico com o BMCAddress especificado. Como esse comando é processado, $BMCRunAsAccount fornece credenciais para Find-SCComputer.

O terceiro comando executa a descoberta profunda no objeto do computador e retorna o objeto de computador físico para $MyComputer 01 variável.

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

Parâmetros

-ADSearchFilter

Define uma consulta do Active Directory para descoberta. Use esse parâmetro para especificar uma consulta que contenha informações de domínio do Active Directory 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 esse cmdlet obtém todos os objetos subordinados independentemente do objeto pai.

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

-BMCAddress

Especifica ou atualiza o endereço BMC (controlador de gerenciamento de base) fora da banda para um computador físico específico. Pode ser um endereço IP, o FQDN (nome de domínio totalmente qualificado) ou o prefixo DNS (que geralmente é o mesmo nome que o nome NetBIOS).

Normalmente, o endereço BMC e sua conexão com a rede são separados do endereço IP associado a um adaptador de rede padrão. Como alternativa, alguns computadores usam 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 exclusiva e, portanto, é exclusivamente identificável na rede.

Exemplo de formato IPv4: -BMCAddress "10.0.0.21"

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

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

Exemplo de formato NetBIOS: -BMCAddress "Computer01"

Observação: por padrão, o VMM usa um endereço IP ou FQDN para o endereço BMC. No entanto, também é possível criar um módulo do PowerShell que permite que você especifique outros tipos de endereços como o endereço BMC.

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

-BMCCustomConfigurationProvider

Especifica ou atualiza um objeto de provedor de configuração para um BMC (controlador de gerenciamento de quadro de base). Um provedor de configuração é um plug-in para o VMM que converte comandos do PowerShell do VMM para chamadas à API específicas para um tipo de controlador de gerenciamento de quadro de base. Esse parâmetro deve ser usado 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 a porta BMC (controlador de gerenciamento de placa base) fora da banda para um computador físico específico. Uma porta BMC também é conhecida como uma porta do processador de serviço. As portas padrão de exemplo são 623 para IPMI e 443 para SMASH sobre WS-Man.

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

-BMCProtocol

Especifica ou atualiza o protocolo que o VMM usa para se comunicar com o BMC (controlador de gerenciamento de placa base fora de banda). Os valores válidos são:

IPMI
ESMAGAR
Personalizado

Um BMC (também conhecido como processador de serviço ou controlador de gerenciamento) é um controlador especializado na placa-mãe de um servidor que atua em uma interface entre o hardware e o software de gerenciamento do sistema. Se a placa-mãe de um computador físico incluir um BMC, quando o computador estiver conectado (se ele estiver desligado ou ligado e se um sistema operacional está instalado ou não), informações sobre o hardware do sistema e o estado dessa integridade de hardware do sistema estarão disponíveis.

Formato de exemplo: -BMCProtocol "Custom"

Observação: o protocolo Personalizado exige que você use 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 Executar como a ser usada com o dispositivo BMC (controlador de gerenciamento de quadro de base).

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 em sua rede. Os valores aceitáveis para esse 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 Active 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 de credencial ou, para alguns cmdlets, um objeto de conta Executar como que contém o nome de usuário e a senha de uma conta que tem permissão para executar essa ação. Ou, no caso de Restart-SCJob, tem permissão para concluir uma tarefa reiniciada.

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

Para obter mais informações sobre contas Executar como, digite 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

Somente para uso interno (não para uso em seu código).

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

-Domain

Especifica um FQDN (nome de domínio totalmente qualificado) para um domínio do Active 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 hosts de máquina virtual atualmente gerenciados pelo VMM.

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

-ExcludeVMMLibrary

Exclui servidores de biblioteca atualmente gerenciados pelo 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

Pesquisa computadores que executam o Windows Server 2008 ou posterior no qual a função de servidor Hyper-V está habilitada.

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 em um intervalo de endereços IP. Use 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 em um intervalo de endereços IP. Use 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 andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-SMBiosGuid

Especifica o IDENTIFICADOR global exclusivo do BIOS (SMBIOS GUID) do System Management para um computador físico associado a um registro para esse computador físico no VMM.

O SMBIOS define estruturas de dados e métodos de acesso que permitem que um usuário ou aplicativo armazene e recupere informações sobre hardware neste computador, como o nome do sistema, do fabricante ou da versão bios do sistema. Os sistemas operacionais Windows recuperam dados SMBIOS na inicialização do sistema e disponibilizam esses dados para 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 CIDR (roteamento de Inter-Domain sem classe).

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

Observação: uma sub-rede IP não pode se sobrepor a nenhuma outra sub-rede em um grupo de host ou grupos de host filho.

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

Saídas

Computer

Este cmdlet retorna um objeto Computer .

Get-SCRunAsAccount

Find-SCComputer

Syntax

Description

Exemplos

Exemplo 1: pesquisar computadores em um domínio específico que atenda aos critérios especificados

Exemplo 2: pesquisar um computador específico por nome e validar suas propriedades no Active Directory

Exemplo 3: pesquisar todos os computadores no domínio especificado que não são um servidor de biblioteca do VMM

Exemplo 4: localizar todos os computadores não gerenciados no domínio especificado usando uma consulta do Active Directory

Exemplo 5: localizar computadores bare-metal que têm controladores fora de banda que estão dentro de um intervalo de rede específico

Exemplo 6: Executar descoberta profunda em um computador físico com suporte a computador bare-metal

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

Links Relacionados

Recursos adicionais