Condividi tramite

Find-SCComputer

  • Riferimento
Modulo:
VirtualMachineManager

Cerca i computer eseguendo query su Active Directory e restituisce gli oggetti computer.

Sintassi

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>]

Descrizione

Il cmdlet Find-SCComputer cerca uno o più computer eseguendo query su Active Directory e restituisce gli oggetti computer.

È possibile utilizzare questo cmdlet per individuare computer in Active Directory in base ai criteri specificati o a una combinazione di criteri, tra cui:

  • Nome di dominio completo (FQDN) di un computer.

  • Tutto o parte del nome del computer.

  • Nome di un dominio.

  • Tutti i computer tranne gli host gestiti da Virtual Machine Manager (VMM).

  • Tutti i computer tranne i server di libreria gestiti da VMM.

  • Solo host Hyper-V.

  • Computer bare metal con controller fuori banda.

Nota: se si aggiunge un nuovo computer, ad esempio un host o un server di libreria, che si trova in un dominio di Active Directory in VMM e quindi si esegue immediatamente il cmdlet Discover-Computer , il cmdlet potrebbe non individuare immediatamente il nuovo computer quando esegue la ricerca in Active Directory. Questo ritardo può verificarsi perché i dati relativi al nuovo computer potrebbero non essere ancora replicati nel dominio di Active Directory. Gli amministratori di dominio possono utilizzare la console Siti e servizi di Active Directory per forzare l'esecuzione immediata della replica dei dati.

Esempio

Esempio 1: Cercare computer in un dominio specifico che soddisfi i criteri specificati

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

Il primo comando ottiene l'oggetto Account RunAs denominato Account computer host 01 e archivia l'oggetto nella variabile $RunAsAccount.

Il secondo comando esegue la query su Active Directory e restituisce un elenco di oggetti computer Hyper-V relativi ai computer che si trovano nel dominio Contoso.com, il cui nome inizia con "host" e non gestiti da VMM. Poiché questo comando viene elaborato, $RunAsAccount fornisce le credenziali per Find-SCComputer.

Nota: quando si usa Find-SCComputer con il parametro Domain , è necessario specificare il nome di dominio completo.

Esempio 2: Cercare un computer specifico in base al nome e convalidarne le proprietà in Active Directory

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

Questo comando usa il nome di dominio completo (FQDN) del computer denominato VMHost01 per trovare questo computer in Active Directory, restituisce l'oggetto computer e visualizza le proprietà dell'oggetto computer all'utente.

Esempio 3: Cercare tutti i computer nel dominio specificato che non sono un server di libreria VMM

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

Il primo comando ottiene l'oggetto Account RunAs denominato Account computer host 01 e archivia l'oggetto nella variabile $RunAsAccount.

Il secondo comando esegue query su Active Directory per tutti i computer nel dominio Contoso.com che includono "vmm" nel nome del computer, ad eccezione dei server di libreria VMM. Poiché questo comando viene elaborato, $RunAsAccount fornisce le credenziali per Find-SCComputer.

Esempio 4: Trovare tutti i computer non gestiti nel dominio specificato usando una query di 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

Il primo comando ottiene l'oggetto Account RunAs denominato Account computer host 01 e archivia l'oggetto nella variabile $RunAsAccount.

Il secondo comando esegue query su Active Directory per tutti i computer nel dominio Contoso.com che soddisfano i criteri di query: qualsiasi computer Windows Server 2008 R2 con un nome che inizia con Test0, ma che non sono server di libreria VMM o host VMM. Poiché questo comando viene elaborato, $RunAsAccount fornisce le credenziali per Find-SCComputer.

Esempio 5: Trovare computer bare metal con controller fuori banda che si trovano all'interno di un intervallo di rete specifico

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

Il primo comando ottiene l'oggetto account RunAs denominato BMC Account 01 e archivia l'oggetto nella variabile $BMCRunAsAccount.

Il secondo comando analizza la rete per un computer fisico con il BMCAddress specificato. Poiché questo comando viene elaborato, $BMCRunAsAccount fornisce le credenziali per Find-SCComputer.

Esempio 6: Eseguire l'individuazione approfondita in un computer fisico con supporto di computer 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

Il primo comando ottiene l'oggetto account RunAs denominato BMC Account 01 e archivia l'oggetto nella variabile $BMCRunAsAccount.

Il secondo comando analizza la rete per un computer fisico con il BMCAddress specificato. Poiché questo comando viene elaborato, $BMCRunAsAccount fornisce le credenziali per Find-SCComputer.

Il terzo comando esegue l'individuazione approfondita nell'oggetto computer e restituisce l'oggetto computer fisico a $MyComputer 01 variabile.

L'ultimo comando visualizza le proprietà dell'oggetto computer archiviato nella variabile $MyComputer 01.

Parametri

-ADSearchFilter

Definisce una query di Active Directory per l'individuazione. Usare questo parametro per specificare una query che contiene informazioni di dominio e filtri di ricerca di Active Directory.

Formato di esempio: -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 che questo cmdlet ottiene tutti gli oggetti subordinati indipendenti dall'oggetto padre.

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

-BMCAddress

Specifica o aggiorna l'indirizzo BMC (Out-of-Band Baseboard Management Controller) per un computer fisico specifico. Questo potrebbe essere un indirizzo IP, il nome di dominio completo (FQDN) o il prefisso DNS (che in genere è lo stesso nome del nome NetBIOS).

In genere, l'indirizzo BMC e la relativa connessione alla rete sono separati dall'indirizzo IP associato a una scheda di rete standard. In alternativa, alcuni computer usano una scheda di rete standard per fornire un singolo indirizzo per BMC e per la scheda di rete. Tuttavia, l'indirizzo BMC ha una porta univoca ed è quindi identificabile in modo univoco nella rete.

Formato IPv4 di esempio: -BMCAddress "10.0.0.21"

Formato Ipv6 di esempio: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"

Formato FQDN di esempio: -BMCAddress "Computer01.Contoso.com"

Formato NetBIOS di esempio: -BMCAddress "Computer01"

Nota: per impostazione predefinita, VMM usa un indirizzo IP o un nome di dominio completo per l'indirizzo BMC. Tuttavia, è anche possibile creare un modulo di PowerShell che consente di specificare altri tipi di indirizzi come indirizzo BMC.

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

-BMCCustomConfigurationProvider

Specifica o aggiorna, un oggetto provider di configurazione per un controller di gestione della scheda di base (BMC). Un provider di configurazione è un plug-in a VMM che converte i comandi di PowerShell VMM alle chiamate API specifiche di un tipo di controller di gestione della scheda di base. Questo parametro deve essere usato con il BMCProtocol personalizzato.

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

-BMCPort

Specifica o aggiorna la porta BMC (Baseboard Management Controller) out-of-band per un computer fisico specifico. Una porta BMC è nota anche come porta del processore di servizi. Le porte predefinite di esempio sono 623 per IPMI e 443 per SMASH su WS-Man.

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

-BMCProtocol

Specifica o aggiorna il protocollo usato da VMM per comunicare con il controller di gestione della baseboard out-of-band (BMC). I valori validi sono:

  • IPMI
  • DISTRUZIONE
  • Personalizzato

Un BMC (noto anche come controller di gestione o processore di servizi) è un controller specializzato sulla scheda madre di un server che agisce un'interfaccia tra l'hardware e il software di gestione del sistema. Se la scheda madre di un computer fisico include una BMC, quando il computer è collegato (se è attivato o attivato e se è installato un sistema operativo), informazioni sull'hardware del sistema e sullo stato di tale integrità hardware del sistema è disponibile.

Formato di esempio: -BMCProtocol "Custom"

Nota: il protocollo personalizzato richiede l'uso del parametro BMCCustomConfigurationProvider .

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

-BMCRunAsAccount

Specifica l'account RunAs da usare con il dispositivo BMC (BaseBoard Management Controller).

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

-ComputerName

Specifica il nome di un computer identificabile in modo univoco da VMM nella rete. I valori validi per questo parametro sono:

  • Nome di dominio completo
  • Indirizzo IPv4 o IPv6
  • Nome NetBIOS
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerNameFilter

Specifica il nome completo o parziale di un computer che il cmdlet tenterà di individuare in Active Directory.

Formato di esempio: -ComputerNameFilter "host"

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

-Credential

Specifica un oggetto credenziale o, per alcuni cmdlet, un oggetto account RunAs contenente il nome utente e la password di un account che dispone dell'autorizzazione per eseguire questa azione. In alternativa, nel caso di Restart-SCJob, è disponibile l'autorizzazione per completare un'attività riavviata.

Per altre informazioni sull'oggetto PSCredential, digitare Get-Help Get-Credential.

Per altre informazioni sugli account RunAs, digitare Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Indica che l'individuazione approfondita viene usata per il computer specificato.

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

-DiscoveryID

Solo per uso interno. Non utilizzare nel codice.

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

-Domain

Specifica un nome di dominio completo (FQDN) per un dominio Active Directory.

Formato di esempio: -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

Esclude gli host di macchine virtuali attualmente gestiti da VMM.

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

-ExcludeVMMLibrary

Esclude i server di libreria attualmente gestiti da VMM.

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

-ExcludeVMs

Esclude le macchine virtuali.

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

-FindHyperVHost

Cerca computer che eseguono Windows Server 2008 o versioni successive in cui è abilitato il ruolo server Hyper-V.

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

-IPAddressRangeEnd

Specifica l'ultimo indirizzo IP in un intervallo di indirizzi IP. Usare con il parametro IPAddressRangeStart .

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

-IPAddressRangeStart

Specifica il primo indirizzo IP in un intervallo di indirizzi IP. Usare con il parametro IPAddressRangeEnd .

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

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

-SMBiosGuid

Specifica l'identificatore univoco globale del BIOS di Gestione sistema (GUID SMBIOS) per un computer fisico associato a un record per tale computer fisico in VMM.

SMBIOS definisce strutture di dati e metodi di accesso che consentono a un utente o all'applicazione di archiviare e recuperare informazioni sull'hardware in questo computer, ad esempio il nome del sistema, del produttore o della versione del BIOS di sistema. I sistemi operativi Windows recuperano i dati SMBIOS all'avvio del sistema e rendono i dati disponibili per i programmi.

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

-Subnet

Specifica una subnet IP (IPv4 o IPv6) Inter-Domain nella notazione routing senza classi (CIDR).

Formato di esempio per una subnet IPv4: 192.168.0.1/24

Formato di esempio per una subnet IPv6: FD4A:29CD:184F:3A2C::/64

Nota: una subnet IP non può sovrapporsi a qualsiasi altra subnet in un gruppo host o gruppi host figlio.

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

Output

Computer

Questo cmdlet restituisce un oggetto Computer .