Find-SCComputer
Recherche des ordinateurs en interrogeant Active Directory et retourne les objets d’ordinateur.
Syntaxe
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 ordinateur.
Vous pouvez utiliser cette applet de commande pour interroger Active Directory pour les ordinateurs en fonction de critères spécifiés ou d’une combinaison de critères, notamment :
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, à l’exception des 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 risque de ne pas découvrir immédiatement le nouvel ordinateur lorsqu’il recherche Active Directory. Ce délai peut se produire, car les données relatives au nouvel ordinateur n’ont peut-être pas encore été répliquées dans le domaine Active Directory. Si vous êtes administrateur de domaine, vous pouvez utiliser la console Sites et services Active Directory pour forcer 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 $RunAsAccountLa 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 une liste d’objets d’ordinateur Hyper-V pour les ordinateurs situés dans le domaine Contoso.com, dont le nom commence par « hôte » et qui ne sont pas gérés par VMM. À mesure que cette commande est traitée, $RunAsAccount fournit des informations d’identification pour 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 $RunAsAccountLa 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, à l’exception des serveurs de bibliothèque VMM. À mesure que cette commande est traitée, $RunAsAccount fournit des informations d’identification pour Find-SCComputer .
Exemple 4 : Rechercher tous les ordinateurs non géré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 $RunAsAccountLa 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 : n’importe quel 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. À mesure que cette commande est traitée, $RunAsAccount fournit des informations d’identification pour Find-SCComputer .
Exemple 5 : Rechercher des ordinateurs nus qui ont des contrôleurs hors bande qui se trouvent dans une plage de 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 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 l’adresse BMCAddress spécifiée. À mesure que cette commande est traitée, $BMCRunAsAccount fournit des informations d’identification pour 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:\> $MyComputer01La première commande obtient l’objet 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 l’adresse BMCAddress spécifiée. À mesure que cette commande est traitée, $BMCRunAsAccount fournit des informations d’identification pour Find-SCComputer .
La troisième commande effectue la découverte approfondie sur l’objet ordinateur et retourne l’objet machine 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-All
Indique que cette applet de commande obtient tous les objets subordonnés indépendamment de l’objet parent.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 façon 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 de nom de domaine complet : -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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 carte de base. Ce paramètre doit être utilisé avec le BMCProtocol personnalisé.
| Type: | ConfigurationProvider |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 ports par défaut sont 623 pour IPMI et 443 pour SMASH sur WS-Man.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BMCProtocol
Spécifie ou met à jour le protocole utilisé par VMM pour communiquer avec le contrôleur de gestion de carte de base hors bande (BMC). Les valeurs valides sont les suivantes :
- IPMI
- BRISER
- Coutume
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 sous tension, et qu’elle soit installée ou non, un système d’exploitation est installé), des informations sur le matériel système et l’état de l’intégrité du matériel du système sont disponibles.
Exemple de format : -BMCProtocol "Custom"
Remarque : Le protocole personnalisé nécessite d’utiliser le paramètre BMCCustomConfigurationProvider.
| Type: | OutOfBandManagementType |
| Valeurs acceptées: | IPMI, SMASH, Custom |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BMCRunAsAccount
Spécifie le compte d’identification à utiliser avec l’appareil BMC (Baseboard Management Controller).
| Type: | RunAsAccount |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ComputerName
Spécifie le nom d’un ordinateur que VMM peut identifier de manière unique sur votre réseau. Les valeurs acceptables pour ce paramètre sont les suivantes :
- FQDN
- Adresse IPv4 ou IPv6
- Nom NetBIOS
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ComputerNameFilter
Spécifie le nom partiel ou complet d’un ordinateur que l’applet de commande tentera de découvrir dans Active Directory.
Exemple de format : -ComputerNameFilter "host"
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 autorisé à 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeepDiscovery
Indique que la découverte approfondie est utilisée pour l’ordinateur spécifié.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DiscoveryID
Pour une utilisation interne uniquement (pas pour une utilisation dans votre code).
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ExcludeVMMHost
Exclut les hôtes de machine virtuelle actuellement gérés par VMM.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ExcludeVMMLibrary
Exclut les serveurs de bibliothèque actuellement gérés par VMM.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ExcludeVMs
Exclut les machines virtuelles.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-FindHyperVHost
Recherche les ordinateurs exécutant Windows Server 2008 ou version ultérieure sur lesquels le rôle serveur Hyper-V est activé.
| Type: | SwitchParameter |
| Alias: | FindHyperVHosts |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-IPAddressRangeEnd
Spécifie la dernière adresse IP dans une plage d’adresses IP. Utiliser avec le paramètre IPAddressRangeStart.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-IPAddressRangeStart
Spécifie la première adresse IP dans une plage d’adresses IP. Utilisez le paramètre IPAddressRangeEnd.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsynchronously
Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SMBiosGuid
Spécifie l’identificateur global unique du BIOS de gestion du système (GUID SMBIOS) pour un ordinateur physique associé à un enregistrement pour cet ordinateur physique dans VMM.
SMBIOS définit des structures de données et des 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 du 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 d’autres sous-réseaux dans un groupe hôte ou des groupes hôtes enfants.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Sorties
Computer
Cette applet de commande retourne un objet Computer.