Partager via

Invoke-SCXDiscovery

  • Référence
Module:
OperationsManager

Appelle l’opération de découverte pour la configuration spécifiée des ordinateurs UNIX et Linux.

Syntaxe

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

La cmdlet 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 Windows PowerShell facultatif pour la communication de l’agent à faible privilèges 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 $SSHCredential

La première commande obtient des informations d’identification pour un utilisateur à l’aide de l’applet de commande Get-Credential. La commande vous invite à entrer 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 $SSHCredential

La première commande obtient des informations d’identification pour un utilisateur à l’aide de Get-Credential . La commande vous invite à entrer 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 la 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
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 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 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IPRange

Spécifie une plage d’adresses IP qui seront utilisées pour la découverte. Le IPRange doit contenir deux adresses IP (par exemple, 192.168.0.1,192.168.0.254). Les paramètres IPRange ou doivent être spécifiés.

Type:IPAddress[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie une liste de noms d’hôtes, 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 doivent être spécifiés. Ce paramètre est accepté à partir du pipeline.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir 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, tapez Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SshPort

Spécifie le port à utiliser pour la communication SSH avec l’hôte. Si elle n’est pas spécifiée, la valeur par défaut 22 est utilisée.

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

-WsManCredential

Spécifie les informations d’identification utilisées pour la communication avec un 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, tapez Get-Help Get-Credential.

Type:PSCredential
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

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.