Find-SCComputer

Riferimento

Modulo:: VirtualMachineManager

Cerca i computer eseguendo una 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 una 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 ad eccezione degli host gestiti da Virtual Machine Manager (VMM).
Tutti i computer ad eccezione dei server di libreria gestiti da VMM.
Solo gli host Hyper-V.
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 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 soddisfano 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. Durante l'elaborazione di questo comando, $RunAsAccount fornisce le credenziali a 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 Account computer host 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 includono "vmm" nel nome del computer, ad eccezione dei server di libreria VMM. Durante l'elaborazione di questo comando, $RunAsAccount fornisce le credenziali a 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 una query di Active Directory per tutti i computer del 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 a 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 a 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 a Find-SCComputer.

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

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*))"

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 (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 il 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 baseboard. 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 scheda di base. Questo parametro deve essere usato con custom BMCProtocol.

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) 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.

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 base fuori banda. I valori validi sono:

IPMI
DISTRUZIONE
Personalizzato

Un BMC (noto anche come controller di gestione o processore di servizio) è 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 un BMC, quando il computer è collegato (se è spento o acceso e se è installato o meno un sistema operativo), sono disponibili informazioni sull'hardware del sistema e sullo stato dell'integrità hardware del sistema.

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

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

-DeepDiscovery

Indica che l'individuazione approfondita viene utilizzata 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 i computer che eseguono Windows Server 2008 o versione successiva in cui è abilitato il ruolo del 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 torni 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 del sistema (GUID SMBIOS) per un computer fisico associato a un record per tale computer fisico in VMM.

SMBIOS definisce le strutture di dati e i 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 del BIOS di sistema. I sistemi operativi Windows recuperano i dati SMBIOS all'avvio del sistema e rendono disponibili i dati 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) 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.

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 .

Get-SCRunAsAccount

Condividi tramite

Find-SCComputer

Sintassi

Descrizione

Esempio

Esempio 1: cercare computer in un dominio specifico che soddisfano 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 soddisfano 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