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 usare questo cmdlet per eseguire query su Active Directory per i computer in base ai criteri specificati o a una combinazione di criteri, tra cui:

Nome di dominio completo (FQDN) di un computer.
Nome completo o parte del computer.
Nome di un dominio.
Tutti i computer tranne gli host gestiti da Virtual Machine Manager (VMM).
Tutti i computer, ad eccezione dei server di libreria gestiti da VMM.
Solo Hyper-V host.
Computer bare metal con controller fuori banda.

Nota: se si aggiunge un nuovo computer, ad esempio un server host o 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 sul nuovo computer potrebbero non essere ancora stati replicati nel dominio di Active Directory. Gli amministratori di dominio possono usare la console siti e servizi di Active Directory per forzare la replica immediata 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 Host Computer Account 01 e archivia l'oggetto nella variabile $RunAsAccount.

Il secondo comando esegue una query in Active Directory e restituisce un elenco di oggetti computer Hyper-V per i computer che si trovano nel dominio Contoso.com, con un nome che inizia con "host" e che non sono gestiti da VMM. Durante l'elaborazione di questo comando, $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 per 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 il 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 Host Computer Account 01 e archivia l'oggetto nella variabile $RunAsAccount.

Il secondo comando esegue una query in Active Directory per tutti i computer nel dominio Contoso.com che includono "vmm" nel nome del computer, ad eccezione dei server di libreria VMM. Durante l'elaborazione di questo comando, $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 Host Computer Account 01 e archivia l'oggetto nella variabile $RunAsAccount.

Il secondo comando esegue una query di 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. Durante l'elaborazione di questo comando, $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. Durante l'elaborazione di questo comando, $BMCRunAsAccount fornisce le credenziali per Find-SCComputer.

Esempio 6: Eseguire l'individuazione approfondita in un computer fisico con supporto per 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. Durante l'elaborazione di questo comando, $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 contenente informazioni sul dominio di Active Directory e filtri di ricerca.

Formato di esempio: -ADSearchFilter``"(&(sAMAccountType=805306369)(name=katarina*)(objectCategory=computer)(objectClass =computer)(operatingSystem=Windows\20Server*))"

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-All

Indica che questo cmdlet ottiene tutti gli oggetti subordinati indipendentemente dall'oggetto padre.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BMCAddress

Specifica o aggiorna l'indirizzo BMC (Baseboard Management Controller) fuori banda per un computer fisico specifico. Potrebbe trattarsi di un indirizzo IP, del nome di dominio completo (FQDN) o del 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 FQDN per l'indirizzo BMC. Tuttavia, è anche possibile creare un modulo di PowerShell che consente di specificare altri tipi di indirizzi come indirizzo BMC.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BMCCustomConfigurationProvider

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

Tipo:	ConfigurationProvider
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BMCPort

Specifica, o aggiorna, la porta BMC (Baseboard Management Controller) fuori banda 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.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BMCProtocol

Specifica, o aggiorna, il protocollo usato da VMM per comunicare con il controller di gestione della lavagna di base fuori banda (BMC). I valori validi sono:

IPMI
DISTRUZIONE
Costume

Un BMC (noto anche come controller di gestione o processore di servizi) è un controller specializzato nella scheda madre di un server che agisce un'interfaccia tra il software di gestione hardware e di sistema. Se la scheda madre di un computer fisico include un BMC, quando il computer è collegato (se è spento o acceso e se è installato o meno 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 .

Tipo:	OutOfBandManagementType
Valori accettati:	IPMI, SMASH, Custom
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BMCRunAsAccount

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

Tipo:	RunAsAccount
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ComputerName

Specifica il nome di un computer che VMM può identificare in modo univoco nella rete. I valori accettabili per questo parametro sono:

FQDN
Indirizzo IPv4 o IPv6
Nome NetBIOS

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ComputerNameFilter

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

Formato di esempio: -ComputerNameFilter "host"

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

Specifica un oggetto credenziale o, per alcuni cmdlet, un oggetto account RunAs che contiene il nome utente e la password di un account che dispone dell'autorizzazione per eseguire questa azione. In alternativa, nel caso di Restart-SCJob, dispone dell'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.

Tipo:	VMMCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DeepDiscovery

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DiscoveryID

Solo per uso interno (non per l'uso nel codice).

Tipo:	Guid
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Domain

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

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ExcludeVMMHost

Esclude gli host di macchine virtuali attualmente gestiti da VMM.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ExcludeVMMLibrary

Esclude i server di libreria attualmente gestiti da VMM.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ExcludeVMs

Esclude le macchine virtuali.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FindHyperVHost

Cerca i computer che eseguono Windows Server 2008 o versione successiva in cui è abilitato il ruolo del server Hyper-V.

Tipo:	SwitchParameter
Alias:	FindHyperVHosts
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IPAddressRangeEnd

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IPAddressRangeStart

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RunAsynchronously

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SMBiosGuid

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

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

Tipo:	Guid
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Subnet

Specifica una subnet IP (IPv4 o IPv6) nella notazione CIDR (Classless Inter-Domain Routing).

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 in gruppi host figlio.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-VMMServer

Specifica un oggetto server VMM.

Tipo:	ServerConnection
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Output

Computer

Questo cmdlet restituisce un oggetto Computer .

Get-SCRunAsAccount

Condividi tramite

Find-SCComputer

Sintassi

Descrizione

Esempio

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

Esempio 2: cercare un computer specifico per nome e convalidarne le proprietà in Active Directory

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

Esempio 4: Trovare tutti i computer non gestiti nel dominio specificato usando una query di Active Directory

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

Esempio 6: Eseguire l'individuazione approfondita in un computer fisico con supporto per computer bare metal

Parametri

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Output

Risorse aggiuntive

Condividi tramite

Find-SCComputer

Sintassi

Descrizione

Esempio

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

Esempio 2: cercare un computer specifico per nome e convalidarne le proprietà in Active Directory

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

Esempio 4: Trovare tutti i computer non gestiti nel dominio specificato usando una query di Active Directory

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

Esempio 6: Eseguire l'individuazione approfondita in un computer fisico con supporto per computer bare metal

Parametri

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Output

Collegamenti correlati

Risorse aggiuntive