Find-SCComputer

Referência

Módulo:: VirtualMachineManager

Procura computadores consultando o Ative Directory e retorna os objetos de computador.

Sintaxe

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 retorna os objetos de computador.

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

O nome de domínio totalmente qualificado (FQDN) de um computador.
Todo ou parte do nome do computador.
O nome de um domínio.
Todos os computadores, exceto hosts gerenciados pelo Virtual Machine Manager (VMM).
Todos os computadores, exceto servidores de biblioteca gerenciados pelo VMM.
Apenas Hyper-V anfitriões.
Computadores bare-metal com controladores fora de banda.

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

Exemplos

Exemplo 1: Pesquisar computadores em um domínio específico que atendam 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 Run As chamado Conta de Computador Host 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Ative 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. À medida que este comando é processado, $RunAsAccount fornece credenciais para Find-SCComputer.

Nota: Quando você usa Find-SCComputer com o parâmetro Domain, você deve especificar o nome de domínio totalmente qualificado.

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

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

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

Exemplo 3: Procurar todos os computadores no domínio especificado que não sejam 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 Run As chamado Conta de Computador Host 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Ative Directory para todos os computadores no domínio Contoso.com que incluem "vmm" no nome do computador, exceto para servidores de biblioteca do VMM. À medida que este 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 Ative 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 Run As chamado Conta de Computador Host 01 e armazena o objeto na variável $RunAsAccount.

O segundo comando consulta o Ative Directory para todos os computadores no domínio Contoso.com que atendem 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. À medida que este comando é processado, $RunAsAccount fornece credenciais para Find-SCComputer.

Exemplo 5: Localizar computadores bare-metal com 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 Run As chamado BMC Account 01 e armazena o objeto na variável $BMCRunAsAccount.

O segundo comando verifica a rede em busca de um computador físico com o endereço BMCAddress especificado. À medida que este comando é processado, $BMCRunAsAccount fornece credenciais para Find-SCComputer.

Exemplo 6: Executar uma descoberta profunda em uma máquina física 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 Run As chamado BMC Account 01 e armazena o objeto na variável $BMCRunAsAccount.

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

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

Parâmetros

-ADSearchFilter

Define uma consulta do Ative Directory para descoberta. Use esse parâmetro para especificar uma consulta que contenha informações de domínio do Ative Directory e filtros de pesquisa.

Exemplo de formato: -ADSearchFilter``"(&(sAMAccountType=805306369)(name=katarina*)(objectCategory=computer)(objectClass =computer)(operatingSystem=Windows\20Server*))"

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentes do objeto pai.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-BMCAddress

Especifica ou atualiza o endereço do controlador de gerenciamento de placa base (BMC) fora de banda para uma máquina física específica. Pode ser um endereço IP, o nome de domínio totalmente qualificado (FQDN) 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 única 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"

Nota: Por predefinição, o VMM utiliza 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 especificar outros tipos de endereços como o endereço BMC.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-BMCCustomConfigurationProvider

Especifica ou atualiza um objeto de provedor de configuração para um controlador de gerenciamento de placa base (BMC). Um provedor de configuração é um plug-in para o VMM que traduz comandos do PowerShell do VMM em chamadas de API específicas para um tipo de controlador de gerenciamento de placa base. Este parâmetro deve ser usado com o BMCProtocol personalizado.

Tipo:	ConfigurationProvider
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-BMCPort

Especifica ou atualiza a porta BMC (controlador de gerenciamento de placa base) fora de banda para uma máquina física específica. Uma porta BMC também é conhecida como uma porta de processador de serviço. Exemplo de portas padrão são 623 para IPMI e 443 para SMASH sobre WS-Man.

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-BMCProtocol

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

IPMI
SMASH
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 como uma interface entre o hardware e o software de gerenciamento do sistema. Se a placa-mãe de uma máquina física incluir um BMC, quando a máquina estiver conectada (se está desligada ou ligada e se um sistema operacional está instalado ou não), as informações sobre o hardware do sistema e o estado da integridade do hardware do sistema estarão disponíveis.

Exemplo de formato: -BMCProtocol "Custom"

Nota: O protocolo personalizado requer que você use o parâmetro BMCCustomConfigurationProvider.

Tipo:	OutOfBandManagementType
Valores aceites:	IPMI, SMASH, Custom
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-BMCRunAsAccount

Especifica a conta Run As a ser usada com o dispositivo BMC (controlador de gerenciamento da placa base).

Tipo:	RunAsAccount
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ComputerName

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

FQDN
Endereço IPv4 ou IPv6
Nome NetBIOS

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ComputerNameFilter

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

Exemplo de formato: -ComputerNameFilter "host"

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Credential

Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Run As 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 Run As, digite Get-Help New-SCRunAsAccount.

Tipo:	VMMCredential
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DeepDiscovery

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DiscoveryID

Apenas para uso interno (não para uso no seu código).

Tipo:	Guid
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Domain

Especifica um nome de domínio totalmente qualificado (FQDN) para um domínio do Ative Directory.

Exemplo de formato: -Domain "Domain01.Corp.Contoso.com"

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ExcludeVMMHost

Exclui hosts de máquina virtual atualmente gerenciados pelo VMM.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ExcludeVMMLibrary

Exclui servidores de biblioteca atualmente gerenciados pelo VMM.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ExcludeVMs

Exclui máquinas virtuais.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-FindHyperVHost

Procura computadores que executam o Windows Server 2008 ou posterior nos quais a função de servidor Hyper-V está habilitada.

Tipo:	SwitchParameter
Aliases:	FindHyperVHosts
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-IPAddressRangeEnd

Especifica o último endereço IP em um intervalo de endereços IP. Use com o IPAddressRangeStart parâmetro.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-IPAddressRangeStart

Especifica o primeiro endereço IP em um intervalo de endereços IP. Use com o parâmetro IPAddressRangeEnd.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-JobVariable

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RunAsynchronously

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SMBiosGuid

Especifica o identificador global exclusivo do BIOS de gerenciamento do sistema (GUID SMBIOS) 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, o fabricante ou a versão do BIOS do sistema. Os sistemas operacionais Windows recuperam dados SMBIOS na inicialização do sistema e disponibilizam esses dados para os programas.

Tipo:	Guid
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Subnet

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

Exemplo de formato para uma sub-rede IPv4: 192.168.0.1/24

Exemplo de formato 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 anfitriões ou grupos de anfitriões filhos.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:	ServerConnection
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Saídas

Computer

Este cmdlet retorna um objeto Computer.

Get-SCRunAsAccount

Partilhar via

Find-SCComputer

Sintaxe

Description

Exemplos

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

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

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

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

Exemplo 5: Localizar computadores bare-metal com controladores fora de banda que estão dentro de um intervalo de rede específico

Exemplo 6: Executar uma descoberta profunda em uma máquina física 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

Recursos adicionais

Partilhar via

Find-SCComputer

Sintaxe

Description

Exemplos

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

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

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

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

Exemplo 5: Localizar computadores bare-metal com controladores fora de banda que estão dentro de um intervalo de rede específico

Exemplo 6: Executar uma descoberta profunda em uma máquina física 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

Ligações Relacionadas

Recursos adicionais