Compartir a través de

Invoke-SCXDiscovery

  • Referencia
Módulo:
OperationsManager

Invoca la operación de detección para la configuración especificada de equipos UNIX y 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

El cmdlet Invoke-SCXDiscovery invoca la operación de detección para la configuración especificada de equipos UNIX y Linux.

La operación usa un objeto de credencial SSH para las acciones de instalación de SSH con privilegios y un objeto de credencial de Windows PowerShell opcional para la comunicación de agente de WS-Management con pocos privilegios. Si el agente se ha instalado manualmente en los hosts de destino, solo se requiere la credencial de WS-Management con pocos privilegios.

La salida de este cmdlet es una matriz de objetos DiscoveryResult que representan el resultado de detección de cada equipo de destino para el que se intentó la detección.

Ejemplos

Ejemplo 1: Detección de equipos UNIX y Linux dentro de un intervalo de direcciones 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

El primer comando obtiene una credencial para un usuario mediante el cmdlet Get-Credential. El comando le pide autenticación y, a continuación, almacena los resultados en la variable $WSCredential.

El segundo comando crea una credencial con privilegios para un usuario mediante el cmdlet Get-SCXSSHCredential. El comando almacena el resultado en la variable $SSHCredential.

El tercer comando obtiene un grupo de recursos denominado pool01 mediante el cmdlet Get-SCOMResourcePool y, a continuación, lo almacena en la variable $Pool 01.

El comando final detecta equipos UNIX y Linux dentro de un intervalo de direcciones IP.

Ejemplo 2: Detección de equipos UNIX y Linux por nombre con un puerto no estándar

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

El primer comando obtiene una credencial para un usuario mediante Get-Credential. El comando le pide autenticación y, a continuación, almacena los resultados en la variable $WSCredential.

El segundo comando crea una credencial con privilegios para un usuario mediante Get-SCXSSHCredential. El comando almacena el resultado en la variable $SSHCredential.

El tercer comando obtiene un grupo de recursos denominado pool01 mediante Get-SCOMResourcePool y, a continuación, lo almacena en la variable $Pool 01.

El comando final detecta equipos UNIX y Linux por su nombre mediante un grupo de recursos y especifica un puerto SSH no estándar.

Ejemplo 3: Detección de equipos UNIX y Linux por nombre

PS C:\>$Pool = Get-SCOMResourcePool "RP1"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -ResourcePool $Pool -WSManCredential "DavidChew"

El primer comando obtiene un grupo de recursos denominado RP1 mediante Get-SCOMResourcePool y, a continuación, lo almacena en la variable $Pool.

El segundo comando detecta equipos UNIX y Linux por nombre donde ya se ha instalado el agente de administración.

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres NetBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe estar activo en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

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

-Credential

Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración. Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , para este parámetro. Para obtener más información sobre los objetos de credenciales, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

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

-IPRange

Especifica un intervalo de direcciones IP que se usarán para la detección. IPRange debe contener dos direcciones IP (por ejemplo, 192.168.0.1,192.168.0.254). Se deben especificar los parámetros IPRange o Name .

Type:IPAddress[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica una lista de nombres de host válidos, FQDN o direcciones IP (separadas por una coma) que se usarán para la detección. Se deben especificar los parámetros IPRange o Name . Este parámetro se acepta desde la canalización.

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

-ResourcePool

Especifica un grupo de recursos de servidores, uno de los cuales se asigna para que sea el servidor de administración actual y los demás que actúan como servidores de administración de copias de seguridad. Este parámetro requiere un objeto de grupo de recursos y devuelve solo los equipos administrados de ese grupo de recursos.

Para obtener información sobre cómo obtener un objeto de grupo de recursos, escriba Get-Help Get-SCOMResourcePool.

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

-SCSession

Especifica una matriz de objetos Connection . Para obtener objetos Connection , use el cmdlet Get-SCOMManagementGroupConnection .

Si no se especifica este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential . Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SshCredential

Especifica una credencial SSH con privilegios que se usa para realizar las acciones de instalación del agente. Si no se especifica este parámetro, se produce un error en la detección a menos que se haya instalado manualmente un agente en el equipo de destino.

Para obtener información sobre cómo obtener un objeto de credencial SSH, escriba Get-Help Get-SCXSSHCredential.

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

-SshPort

Especifica el puerto que se va a usar para la comunicación SSH con el host. Si no se especifica, se usa el valor predeterminado de 22.

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

-WsManCredential

Especifica una credencial usada para la comunicación con agentes con pocos privilegios a través de WS-Management.

Escriba un nombre de usuario, como User01 o escriba un objeto PSCredential , como uno devuelto por el cmdlet Get-Credential. Cuando escriba un nombre de usuario, se le solicitará una contraseña. Para obtener más información, escriba Get-Help Get-Credential.

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

Salidas

DiscoveryResult

Este cmdlet devuelve una matriz de objetos DiscoveryResult que representan el resultado de detección de cada equipo de destino para el que se planeó la detección.