Invoke-SCXDiscovery
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 $SSHCredentialEl 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 $SSHCredentialEl 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.