Invoke-SCXDiscovery
Appelle l’opération de découverte pour la configuration spécifiée des ordinateurs UNIX et Linux.
Syntax
Invoke-SCXDiscovery
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
-Name <String[]>
-ResourcePool <ManagementServicePool>
[-SshPort <Int32>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Invoke-SCXDiscovery
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
-ResourcePool <ManagementServicePool>
-IPRange <IPAddress[]>
[-SshPort <Int32>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Description
L’applet de commande Invoke-SCXDiscovery appelle l’opération de découverte pour la configuration spécifiée des ordinateurs UNIX et Linux.
L’opération utilise un objet d’informations d’identification SSH pour les actions d’installation SSH privilégiées et un objet d’informations d’identification facultatif Windows PowerShell pour la communication de l’agent à faible privilège WS-Management. Si l’agent a été installé manuellement sur les hôtes ciblés, seules les informations d’identification à faible privilège WS-Management sont requises.
La sortie de cette applet de commande est un tableau d’objets DiscoveryResult représentant le résultat de la découverte pour chaque ordinateur ciblé pour lequel la découverte a été tentée.
Exemples
Exemple 1 : Découvrir des ordinateurs UNIX et Linux dans une plage d’adresses IP
PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key22.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool "pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredentialLa première commande obtient des informations d’identification pour un utilisateur à l’aide de l’applet de commande Get-Credential. La commande vous invite à l’authentification, puis stocke les résultats dans la variable $WSCredential.
La deuxième commande crée des informations d’identification privilégiées pour un utilisateur à l’aide de l’applet de commande Get-SCXSSHCredential. La commande stocke le résultat dans la variable $SSHCredential.
La troisième commande obtient un pool de ressources nommé pool01 à l’aide de l’applet de commande Get-SCOMResourcePool, puis le stocke dans la variable $Pool 01.
La commande finale découvre les ordinateurs UNIX et Linux dans une plage d’adresses IP.
Exemple 2 : Découvrir les ordinateurs UNIX et Linux par nom avec un port non standard
PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key c:\keys\DavidChew.ppk -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -SSHPort 8022 -ResourcePool $Pool01 -WSManCredential $WSCredential -SSHCredential $SSHCredentialLa première commande obtient des informations d’identification pour un utilisateur à l’aide de Get-Credential. La commande vous invite à l’authentification, puis stocke les résultats dans la variable $WSCredential.
La deuxième commande crée des informations d’identification privilégiées pour un utilisateur à l’aide de Get-SCXSSHCredential. La commande stocke le résultat dans la variable $SSHCredential.
La troisième commande obtient un pool de ressources nommé pool01 à l’aide de Get-SCOMResourcePool, puis le stocke dans la variable $Pool 01.
La commande finale découvre les ordinateurs UNIX et Linux par nom à l’aide d’un pool de ressources et en spécifiant un port SSH non standard.
Exemple 3 : Découvrir les ordinateurs UNIX et Linux par nom
PS C:\>$Pool = Get-SCOMResourcePool "RP1"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -ResourcePool $Pool -WSManCredential "DavidChew"La première commande obtient un pool de ressources nommé RP1 à l’aide de Get-SCOMResourcePool, puis le stocke dans la variable $Pool.
La deuxième commande découvre les ordinateurs UNIX et Linux par nom où l’agent de gestion a déjà été installé.
Paramètres
-ComputerName
Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).
Le service System Center Data Access doit être actif sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Spécifie le compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécute.
Spécifiez un objet PSCredential , tel que celui retourné par l’applet de commande Get-Credential , pour ce paramètre.
Pour plus d’informations sur les objets d’informations d’identification, tapez Get-Help Get-Credential.
Si vous spécifiez un ordinateur dans le paramètre ComputerName , utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPRange
Spécifie une plage d’adresses IP qui seront utilisées pour la découverte. IpRange doit contenir deux adresses IP (par exemple, 192.168.0.1,192.168.0.254). Les paramètres IPRange ou Name doivent être spécifiés.
| Type: | IPAddress[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Spécifie une liste de noms d’hôte, de noms de domaine complets ou d’adresses IP valides (séparées par une virgule) qui seront utilisées pour la découverte. Les paramètres IPRange ou Name doivent être spécifiés. Ce paramètre est accepté à partir du pipeline.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourcePool
Spécifie un pool de ressources de serveurs, dont l’un est affecté comme serveur d’administration actuel et les autres servant de serveurs d’administration de sauvegarde. Ce paramètre nécessite un objet de pool de ressources et retourne uniquement les ordinateurs gérés de ce pool de ressources.
Pour plus d’informations sur l’obtention d’un objet de pool de ressources, tapez Get-Help Get-SCOMResourcePool.
| Type: | ManagementServicePool |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
Spécifie un tableau d’objets Connection . Pour obtenir des objets Connection , utilisez l’applet de commande Get-SCOMManagementGroupConnection .
Si ce paramètre n’est pas spécifié, l’applet de commande utilise la connexion persistante active à un groupe d’administration.
Utilisez le paramètre SCSession pour spécifier une connexion persistante différente.
Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential .
Pour plus d'informations, voir Get-Help about_OpsMgr_Connections.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SshCredential
Spécifie des informations d’identification SSH privilégiées utilisées pour effectuer les actions d’installation de l’agent. Si ce paramètre n’est pas spécifié, la découverte échoue, sauf si un agent a été installé manuellement sur l’ordinateur ciblé.
Pour plus d’informations sur l’obtention d’un objet d’informations d’identification SSH, tapez Get-Help Get-SCXSSHCredential.
| Type: | CredentialSet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SshPort
Spécifie le port à utiliser pour la communication SSH avec l’hôte. S’il n’est pas spécifié, la valeur par défaut 22 est utilisée.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WsManCredential
Spécifie les informations d’identification utilisées pour la communication de l’agent à faible privilège via WS-Management.
Tapez un nom d’utilisateur, tel que User01 ou entrez un objet PSCredential , tel qu’un objet retourné par l’applet de commande Get-Credential.
Lorsque vous tapez un nom d’utilisateur, vous êtes invité à entrer un mot de passe.
Pour plus d'informations, voir Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Sorties
DiscoveryResult
Cette applet de commande retourne un tableau d’objets DiscoveryResult représentant le résultat de la découverte pour chaque ordinateur ciblé pour lequel la découverte a été planifiée.