Find-SCComputer

Référence

Module:: VirtualMachineManager

Recherche les ordinateurs en interrogeant Active Directory et retourne les objets d’ordinateur.

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

L’applet de commande Find-SCComputer recherche un ou plusieurs ordinateurs en interrogeant Active Directory et retourne les objets d’ordinateur.

Vous pouvez utiliser cette cmdlet pour interroger Active Directory afin qu’il indique les ordinateurs répondant à un ou plusieurs critères spécifiques, tels que les suivants :

Nom de domaine complet (FQDN) d’un ordinateur.
Tout ou partie du nom de l’ordinateur.
Nom d’un domaine.
Tous les ordinateurs sauf les hôtes gérés par Virtual Machine Manager (VMM).
Tous les ordinateurs sauf les serveurs de bibliothèque gérés par VMM.
Seuls les hôtes Hyper-V.
Ordinateurs nus qui ont des contrôleurs hors bande.

Remarque : si vous ajoutez un nouvel ordinateur, tel qu’un hôte ou un serveur de bibliothèque, situé dans un domaine Active Directory à VMM, puis exécutez immédiatement l’applet de commande Discover-Computer , l’applet de commande peut ne pas immédiatement découvrir le nouvel ordinateur lorsqu’il recherche Active Directory. Ce délai peut se produire car les données sur le nouvel ordinateur n’ont peut-être pas encore été répliquées sur le domaine Active Directory. Si vous êtes administrateur de domaine, vous pouvez utiliser la console Sites et services Active Directory pour imposer la réplication immédiate des données.

Exemples

Exemple 1 : Rechercher des ordinateurs dans un domaine spécifique qui répondent aux critères spécifiés

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

La première commande obtient l’objet de compte d’identification nommé Compte d’ordinateur hôte 01 et stocke l’objet dans la variable $RunAsAccount.

La deuxième commande interroge Active Directory et retourne la liste des objets ordinateurs Hyper-V correspondant aux ordinateurs situés dans le domaine Contoso.com, dont le nom commence par « host » et qui ne sont pas gérés par VMM. Comme cette commande est traitée, $RunAsAccount fournit des informations d’identification à Find-SCComputer.

Remarque : lorsque vous utilisez Find-SCComputer avec le paramètre Domaine , vous devez spécifier le nom de domaine complet.

Exemple 2 : Rechercher un ordinateur spécifique par nom et valider ses propriétés dans Active Directory

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

Cette commande utilise le nom de domaine complet (FQDN) de l’ordinateur nommé VMHost01 pour rechercher cet ordinateur dans Active Directory, retourne l’objet ordinateur et affiche les propriétés de l’objet ordinateur à l’utilisateur.

Exemple 3 : Rechercher tous les ordinateurs du domaine spécifié qui ne sont pas un serveur de bibliothèque VMM

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

La première commande obtient l’objet de compte d’identification nommé Compte d’ordinateur hôte 01 et stocke l’objet dans la variable $RunAsAccount.

La deuxième commande interroge Active Directory pour tous les ordinateurs du domaine Contoso.com qui incluent « vmm » dans le nom de l’ordinateur, sauf pour les serveurs de bibliothèque VMM. Comme cette commande est traitée, $RunAsAccount fournit des informations d’identification à Find-SCComputer.

Exemple 4 : Rechercher tous les ordinateurs non managés dans le domaine spécifié à l’aide d’une requête 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

La première commande obtient l’objet de compte d’identification nommé Compte d’ordinateur hôte 01 et stocke l’objet dans la variable $RunAsAccount.

La deuxième commande interroge Active Directory pour tous les ordinateurs du domaine Contoso.com qui répondent aux critères de requête : tout ordinateur Windows Server 2008 R2 avec un nom qui commence par Test0, mais qui ne sont pas des serveurs de bibliothèque VMM ou des hôtes VMM. Comme cette commande est traitée, $RunAsAccount fournit des informations d’identification à Find-SCComputer.

Exemple 5 : Rechercher des ordinateurs nus qui ont des contrôleurs hors bande qui se trouvent dans une plage réseau spécifique

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

La première commande obtient l’objet de compte d’identification nommé BMC Account 01 et stocke l’objet dans la variable $BMCRunAsAccount.

La deuxième commande analyse le réseau pour un ordinateur physique avec la BMCAddress spécifiée. À mesure que cette commande est traitée, $BMCRunAsAccount fournit des informations d’identification à Find-SCComputer.

Exemple 6 : Effectuer une découverte approfondie sur une machine physique avec prise en charge de l’ordinateur nu

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

La première commande obtient l’objet de compte d’identification nommé BMC Account 01 et stocke l’objet dans la variable $BMCRunAsAccount.

La troisième commande effectue la découverte approfondie sur l’objet ordinateur et retourne l’objet d’ordinateur physique à $MyComputer 01 variable.

La dernière commande affiche les propriétés de l’objet ordinateur stocké dans la variable $MyComputer 01.

Paramètres

-ADSearchFilter

Définit une requête Active Directory pour la découverte. Utilisez ce paramètre pour spécifier une requête qui contient des informations de domaine Active Directory et des filtres de recherche.

Exemple de format : -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

Indique que cette applet de commande obtient tous les objets subordonnés indépendants de l’objet parent.

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

-BMCAddress

Spécifie ou met à jour l’adresse BMC (Out-Of-Band Baseboard Management Controller) pour une machine physique spécifique. Il peut s’agir d’une adresse IP, du nom de domaine complet (FQDN) ou du préfixe DNS (qui est généralement le même nom que le nom NetBIOS).

En règle générale, l’adresse BMC et sa connexion au réseau sont distinctes de l’adresse IP associée à une carte réseau standard. Par ailleurs, certains ordinateurs utilisent une carte réseau standard pour fournir une adresse unique pour la console BMC et pour la carte réseau. Toutefois, l’adresse BMC a un port unique et est donc identifiable de manière unique sur le réseau.

Exemple de format IPv4 : -BMCAddress "10.0.0.21"

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

Exemple de format FQDN : -BMCAddress "Computer01.Contoso.com"

Exemple de format NetBIOS : -BMCAddress "Computer01"

Remarque : par défaut, VMM utilise une adresse IP ou un nom de domaine complet pour l’adresse BMC. Toutefois, il est également possible de créer un module PowerShell qui vous permet de spécifier d’autres types d’adresses comme adresse BMC.

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

-BMCCustomConfigurationProvider

Spécifie ou met à jour un objet fournisseur de configuration pour un contrôleur de gestion de tableau de base (BMC). Un fournisseur de configuration est un plug-in à VMM qui traduit les commandes PowerShell VMM en appels d’API spécifiques à un type de contrôleur de gestion de tableau de base. Ce paramètre doit être utilisé avec le BMCProtocol personnalisé.

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

-BMCPort

Spécifie, ou met à jour, le port BMC (Out-Of-Band Baseboard Management Controller) pour une machine physique spécifique. Un port BMC est également appelé port de processeur de service. Les exemples de ports par défaut sont 623 pour IPMI et 443 pour SMASH sur WS-Man.

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

-BMCProtocol

Spécifie ou met à jour le protocole que VMM utilise pour communiquer avec le contrôleur de gestion de carte de base de base hors bande (BMC). Les valeurs autorisées sont :

IPMI
SMASH
Custom

Un contrôleur BMC (également appelé processeur de service ou contrôleur de gestion) est un contrôleur spécialisé sur la carte mère d’un serveur qui agit une interface entre le logiciel de gestion du matériel et du système. Si la carte mère d’une machine physique comprend une console BMC, lorsque la machine est branchée (qu’elle soit désactivée ou activée, et si un système d’exploitation est installé), des informations sur le matériel système et l’état de cette intégrité matérielle du système sont disponibles.

Exemple de format : -BMCProtocol "Custom"

Remarque : Le protocole personnalisé nécessite que vous utilisiez le paramètre BMCCustomConfigurationProvider .

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

-BMCRunAsAccount

Spécifie le compte d’identification à utiliser avec l’appareil BMC (Baseboard Management Controller).

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

-ComputerName

Spécifie le nom d’un ordinateur que VMM peut identifier de manière unique sur votre réseau. Les valeurs valides pour ce paramètre sont :

FQDN
Adresse IPv4 ou IPv6
Nom NetBIOS

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

-ComputerNameFilter

Spécifie le nom partiel ou complet d’un ordinateur que la cmdlet doit essayer de découvrir dans Active Directory.

Exemple de format : -ComputerNameFilter "host"

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

-Credential

Spécifie un objet d’informations d’identification ou, pour certaines applets de commande, un objet de compte d’identification qui contient le nom d’utilisateur et le mot de passe d’un compte disposant de l’autorisation d’effectuer cette action. Ou, dans le cas de Restart-SCJob, dispose de l’autorisation d’effectuer une tâche redémarrée.

Pour plus d’informations sur l’objet PSCredential, tapez Get-Help Get-Credential.

Pour plus d’informations sur les comptes d’identification, tapez Get-Help New-SCRunAsAccount.

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

-DeepDiscovery

Indique que la découverte approfondie est utilisée pour l’ordinateur spécifié.

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

-DiscoveryID

Utilisation interne seulement (ne pas utiliser dans votre code).

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

-Domain

Spécifie un nom de domaine complet (FQDN) pour un domaine Active Directory.

Exemple de format : -Domain "Domain01.Corp.Contoso.com"

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

-ExcludeVMMHost

Exclut les hôtes de machine virtuelle actuellement gérés par VMM.

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

-ExcludeVMMLibrary

Exclut les serveurs de bibliothèque actuellement gérés par VMM.

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

-ExcludeVMs

Exclut les machines virtuelles.

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

-FindHyperVHost

Recherche les ordinateurs exécutant Windows Server 2008 ou version ultérieure sur lesquels le rôle de serveur Hyper-V est activé.

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

-IPAddressRangeEnd

Spécifie la dernière adresse IP dans une plage d’adresses IP. Utilisez le paramètre IPAddressRangeStart .

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

-IPAddressRangeStart

Spécifie la première adresse IP dans une plage d’adresses IP. Utilisez le paramètre IPAddressRangeEnd .

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

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-SMBiosGuid

Spécifie l’identificateur global unique du BIOS de gestion du système (SMBIOS GUID) pour un ordinateur physique associé à un enregistrement pour cet ordinateur physique dans VMM.

SMBIOS définit les structures de données et les méthodes d’accès qui permettent à un utilisateur ou à une application de stocker et de récupérer des informations sur le matériel sur cet ordinateur, telles que le nom du système, du fabricant ou de la version du BIOS système. Les systèmes d’exploitation Windows récupèrent les données SMBIOS au démarrage du système et rendent ces données disponibles pour les programmes.

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

-Subnet

Spécifie un sous-réseau IP (IPv4 ou IPv6) en notation CIDR (Classless Inter-Domain Routing).

Exemple de format pour un sous-réseau IPv4 : 192.168.0.1/24

Exemple de format pour un sous-réseau IPv6 : FD4A:29CD:184F:3A2C::/64

Remarque : un sous-réseau IP ne peut pas chevaucher tout autre sous-réseau d’un groupe hôte ou d’un groupe hôte enfant.

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

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

Computer

Cette applet de commande retourne un objet Ordinateur .

Get-SCRunAsAccount

Partager via

Find-SCComputer

Syntax

Description

Exemples

Exemple 1 : Rechercher des ordinateurs dans un domaine spécifique qui répondent aux critères spécifiés

Exemple 2 : Rechercher un ordinateur spécifique par nom et valider ses propriétés dans Active Directory

Exemple 3 : Rechercher tous les ordinateurs du domaine spécifié qui ne sont pas un serveur de bibliothèque VMM

Exemple 4 : Rechercher tous les ordinateurs non managés dans le domaine spécifié à l’aide d’une requête Active Directory

Exemple 5 : Rechercher des ordinateurs nus qui ont des contrôleurs hors bande qui se trouvent dans une plage réseau spécifique

Exemple 6 : Effectuer une découverte approfondie sur une machine physique avec prise en charge de l’ordinateur nu

Paramètres

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Sorties

Ressources supplémentaires

Partager via

Find-SCComputer

Syntax

Description

Exemples

Exemple 1 : Rechercher des ordinateurs dans un domaine spécifique qui répondent aux critères spécifiés

Exemple 2 : Rechercher un ordinateur spécifique par nom et valider ses propriétés dans Active Directory

Exemple 3 : Rechercher tous les ordinateurs du domaine spécifié qui ne sont pas un serveur de bibliothèque VMM

Exemple 4 : Rechercher tous les ordinateurs non managés dans le domaine spécifié à l’aide d’une requête Active Directory

Exemple 5 : Rechercher des ordinateurs nus qui ont des contrôleurs hors bande qui se trouvent dans une plage réseau spécifique

Exemple 6 : Effectuer une découverte approfondie sur une machine physique avec prise en charge de l’ordinateur nu

Paramètres

-ADSearchFilter

-All

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-ComputerName

-ComputerNameFilter

-Credential

-DeepDiscovery

-DiscoveryID

-Domain

-ExcludeVMMHost

-ExcludeVMMLibrary

-ExcludeVMs

-FindHyperVHost

-IPAddressRangeEnd

-IPAddressRangeStart

-JobVariable

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMMServer

Sorties

Liens associés

Ressources supplémentaires