Find-SCComputer

  • Referencia
Módulo:
VirtualMachineManager

Busca equipos consultando Active Directory y devuelve los objetos de equipo.

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

El cmdlet Find-SCComputer busca uno o varios equipos consultando Active Directory y devuelve los objetos de equipo.

Puede usar este cmdlet para consultar a Active Directory por las máquinas según los criterios especificados o una combinación de criterios, entre los que se incluyen:

  • Nombre de dominio completo (FQDN) de un equipo.

  • Todo o parte del nombre del equipo.

  • Nombre de un dominio.

  • Todos los equipos excepto los hosts administrados por Virtual Machine Manager (VMM).

  • Todos los equipos excepto los servidores de biblioteca administrados por VMM.

  • Solo hosts de Hyper-V.

  • Equipos sin sistema operativo que tienen controladores fuera de banda.

Nota: Si agrega un equipo nuevo, como un host o un servidor de biblioteca, ubicado en un dominio de Active Directory a VMM y, a continuación, ejecuta inmediatamente el cmdlet Discover-Computer , es posible que el cmdlet no detecte inmediatamente el nuevo equipo cuando busque Active Directory. Este retraso puede producirse porque es posible que los datos sobre el nuevo equipo no se hayan replicado todavía en el dominio de Active Directory. Si es un administrador de dominio, puede usar la consola Sitios y servicios de Active Directory para forzar la replicación de los datos de inmediato.

Ejemplos

Ejemplo 1: Buscar equipos en un dominio específico que cumplan los criterios especificados

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

El primer comando obtiene el objeto de cuenta de ejecución denominado Cuenta de equipo host 01 y almacena el objeto en la variable $RunAsAccount.

El segundo comando consulta a Active Directory y devuelve una lista de objetos de equipo de Hyper-V para los equipos ubicados en el dominio Contoso.com con un nombre que empiece por "host" y no sean administrados por VMM. A medida que se procesa este comando, $RunAsAccount proporciona credenciales a Find-SCComputer.

Nota: Al usar Find-SCComputer con el parámetro Domain , debe especificar el nombre de dominio completo.

Ejemplo 2: Buscar un equipo específico por nombre y validar sus propiedades en Active Directory

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

Este comando usa el nombre de dominio completo (FQDN) del equipo denominado VMHost01 para buscar este equipo en Active Directory, devuelve el objeto de equipo y muestra las propiedades del objeto de equipo al usuario.

Ejemplo 3: Buscar todos los equipos del dominio especificado que no son un 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

El primer comando obtiene el objeto de cuenta de ejecución denominado Cuenta de equipo host 01 y almacena el objeto en la variable $RunAsAccount.

El segundo comando consulta Active Directory para todos los equipos del dominio Contoso.com que incluyen "vmm" en el nombre del equipo, excepto para los servidores de biblioteca VMM. A medida que se procesa este comando, $RunAsAccount proporciona credenciales a Find-SCComputer.

Ejemplo 4: Buscar todos los equipos no administrados en el dominio especificado mediante una consulta de 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

El primer comando obtiene el objeto de cuenta de ejecución denominado Cuenta de equipo host 01 y almacena el objeto en la variable $RunAsAccount.

El segundo comando consulta Active Directory para todos los equipos del dominio Contoso.com que cumplen los criterios de consulta: cualquier equipo de Windows Server 2008 R2 con un nombre que comience por Test0, pero que no sean servidores de biblioteca VMM o hosts VMM. A medida que se procesa este comando, $RunAsAccount proporciona credenciales a Find-SCComputer.

Ejemplo 5: Buscar equipos sin sistema operativo que tienen controladores fuera de banda que están dentro de un intervalo de red específico

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

El primer comando obtiene el objeto de cuenta de ejecución denominado BMC Account 01 y almacena el objeto en la variable $BMCRunAsAccount.

El segundo comando examina la red de un equipo físico con el BMCAddress especificado. A medida que se procesa este comando, $BMCRunAsAccount proporciona credenciales a Find-SCComputer.

Ejemplo 6: Realizar una detección profunda en una máquina física con compatibilidad con equipos sin sistema operativo

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

El primer comando obtiene el objeto de cuenta de ejecución denominado BMC Account 01 y almacena el objeto en la variable $BMCRunAsAccount.

El segundo comando examina la red de un equipo físico con el BMCAddress especificado. A medida que se procesa este comando, $BMCRunAsAccount proporciona credenciales a Find-SCComputer.

El tercer comando realiza la detección en profundidad en el objeto de equipo y devuelve el objeto de máquina física a $MyComputer 01 variable.

El último comando muestra las propiedades del objeto de equipo almacenados en la variable $MyComputer 01.

Parámetros

-ADSearchFilter

Define una consulta de Active Directory para la detección. Use este parámetro para especificar una consulta que contenga filtros de búsqueda e información de dominio de Active Directory.

Formato de ejemplo: -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 obtiene todos los objetos subordinados independientemente del objeto primario.

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

-BMCAddress

Especifica, o actualiza, la dirección del controlador de administración de placa base (BMC) fuera de banda para una máquina física específica. Puede tratarse de una dirección IP, el nombre de dominio completo (FQDN) o el prefijo DNS (que suele ser el mismo nombre que el nombre NetBIOS).

Normalmente, la dirección BMC y su conexión a la red son independientes de la dirección IP asociada a un adaptador de red estándar. Como alternativa, algunos equipos usan un adaptador de red estándar para proporcionar una única dirección para el BMC y para el adaptador de red. Sin embargo, la dirección BMC tiene un puerto único y, por tanto, es identificable de forma única en la red.

Ejemplo de formato IPv4: -BMCAddress "10.0.0.21"

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

Formato FQDN de ejemplo: -BMCAddress "Computer01.Contoso.com"

Ejemplo de formato NetBIOS: -BMCAddress "Computer01"

Nota: De forma predeterminada, VMM usa una dirección IP o un FQDN para la dirección BMC. Sin embargo, también es posible crear un módulo de PowerShell que le permita especificar otros tipos de direcciones como dirección BMC.

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

-BMCCustomConfigurationProvider

Especifica, o actualiza, un objeto de proveedor de configuración para un controlador de administración de placa base (BMC). Un proveedor de configuración es un complemento de VMM que traduce comandos de PowerShell de VMM a llamadas API específicas de un tipo de controlador de administración de placa base. Este parámetro se debe usar con el BMCProtocol personalizado.

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

-BMCPort

Especifica, o actualiza, el puerto del controlador de administración de placa base (BMC) fuera de banda para una máquina física específica. Un puerto BMC también se conoce como puerto de procesador de servicios. Los puertos predeterminados de ejemplo son 623 para IPMI y 443 para SMASH a través de WS-Man.

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

-BMCProtocol

Especifica, o actualiza, el protocolo que VMM usa para comunicarse con el controlador de administración de placa base fuera de banda (BMC). Los valores válidos son:

  • IPMI
  • APLASTAR
  • Personalizado

Un BMC (también conocido como procesador de servicios o controlador de administración) es un controlador especializado en la placa base de un servidor que actúa como una interfaz entre el hardware y el software de administración del sistema. Si la placa base de una máquina física incluye un BMC, cuando la máquina está conectada (ya sea apagada o apagada, y si está instalado o no un sistema operativo), la información sobre el hardware del sistema y el estado de ese estado de hardware del sistema está disponible.

Formato de ejemplo: -BMCProtocol "Custom"

Nota: El protocolo personalizado requiere que use el 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 la cuenta de ejecución que se va a usar con el dispositivo del controlador de administración de placa base (BMC).

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

-ComputerName

Especifica el nombre de un equipo que VMM puede identificar de forma única en su red. Los valores permitidos para este parámetro son los siguientes:

  • FQDN
  • Dirección IPv4 o IPv6
  • Nombre de NetBIOS
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerNameFilter

Especifica el nombre parcial o completo de un equipo que el cmdlet intenta detectar en Active Directory.

Formato de ejemplo: -ComputerNameFilter "host"

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

-Credential

Especifica un objeto de credencial o, para algunos cmdlets, un objeto de cuenta de ejecución que contiene el nombre de usuario y la contraseña de una cuenta que tiene permiso para realizar esta acción. O bien, en el caso de Restart-SCJob, tiene permiso para completar una tarea reiniciada.

Para obtener más información sobre el objeto PSCredential, escriba Get-Help Get-Credential.

Para obtener más información sobre las cuentas de ejecución, escriba Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Indica que la detección profunda se usa para el equipo especificado.

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

-DiscoveryID

Sólo para uso interno (no para usar en el código).

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

-Domain

Especifica un nombre de dominio completo (FQDN) para un dominio de Active Directory.

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

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

-ExcludeVMMHost

Excluye los hosts de máquina virtual administrados actualmente por VMM.

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

-ExcludeVMMLibrary

Excluye los servidores de biblioteca administrados por VMM.

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

-ExcludeVMs

Excluye las máquinas virtuales.

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

-FindHyperVHost

Busca equipos que ejecutan Windows Server 2008 o posterior en los que está habilitado el rol de servidor de Hyper-V.

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

-IPAddressRangeEnd

Especifica la última dirección IP en un intervalo de direcciones IP. Use con el parámetro IPAddressRangeStart .

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

-IPAddressRangeStart

Especifica la primera dirección IP en un intervalo de direcciones IP. Use con el parámetro IPAddressRangeEnd .

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.

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

-SMBiosGuid

Especifica el identificador único global del BIOS de administración del sistema (GUID de SMBIOS) para un equipo físico asociado a un registro para ese equipo físico en VMM.

SMBIOS define estructuras de datos y métodos de acceso que permiten a un usuario o aplicación almacenar y recuperar información sobre el hardware en este equipo, como el nombre del sistema, el fabricante o la versión del BIOS del sistema. Los sistemas operativos Windows recuperan datos SMBIOS al iniciar el sistema y hacen que esos datos estén disponibles para los programas.

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

-Subnet

Especifica una subred IP (IPv4 o IPv6) en notación de Inter-Domain enrutamiento sin clases (CIDR).

Formato de ejemplo para una subred IPv4: 192.168.0.1/24

Formato de ejemplo para una subred IPv6: FD4A:29CD:184F:3A2C::/64

Nota: Una subred IP no se puede superponer con ninguna otra subred de un grupo host o grupos host secundarios.

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

-VMMServer

Especifica un objeto de servidor VMM.

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

Salidas

Computer

Este cmdlet devuelve un objeto Computer .