Invoke-SCXDiscovery
Invoca la operación de detección para la configuración especificada de equipos UNIX y Linux.
Sintaxis
FromHostNameAndResourcePoolParameterSetName
Invoke-SCXDiscovery
-Name <String[]>
-ResourcePool <ManagementServicePool>
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
[-SshPort <Int32>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromIPRangeAndResourcePoolParameterSetName
Invoke-SCXDiscovery
-ResourcePool <ManagementServicePool>
-IPRange <IPAddress[]>
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
[-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 SSH con privilegios y un objeto de credencial de Windows PowerShell opcional para la comunicación del agente WS-Management con privilegios bajos. Si el agente se ha instalado manualmente en los hosts de destino, solo se requiere la credencial de WS-Management con privilegios bajos.
El resultado de este cmdlet es una matriz de objetos DiscoveryResult que representan el resultado de la detección para 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 solicita la 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 descubre equipos UNIX y Linux dentro de un rango 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 solicita la 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 los equipos UNIX y Linux por nombre utilizando un grupo de recursos y especificando 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 los equipos UNIX y Linux por su 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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Credential
Especifica la cuenta de usuario con la que se ejecuta la conexión del grupo de administración.
Especifique un objeto PSCredential , como uno que devuelva el cmdlet Get-Credential , para este parámetro.
Para obtener más información acerca de los objetos de credencial, 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.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IPRange
Especifica un rango de direcciones IP que se usarán para la detección. El 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 .
Propiedades del parámetro
| Tipo: | IPAddress[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromIPRangeAndResourcePoolParameterSetName
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Especifica una lista de nombres de host, FQDN o direcciones IP válidos (separados 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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FromHostNameAndResourcePoolParameterSetName
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ResourcePool
Especifica un grupo de recursos de servidores, uno de los cuales se asigna para ser el servidor de administración actual y los otros 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.
Propiedades del parámetro
| Tipo: | ManagementServicePool |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Utilice 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.
Propiedades del parámetro
| Tipo: | Connection[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SshCredential
Especifica una credencial SSH privilegiada utilizada 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.
Propiedades del parámetro
| Tipo: | CredentialSet |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SshPort
Especifica el puerto que se utilizará para la comunicación SSH con el host. Si no se especifica, se utiliza el valor predeterminado de 22.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WsManCredential
Especifica una credencial utilizada para la comunicación del agente con privilegios bajos 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.
Al escribir un nombre de usuario, se le pedirá una contraseña.
Para obtener más información, escriba Get-Help Get-Credential.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Salidas
DiscoveryResult
Este cmdlet devuelve una matriz de objetos DiscoveryResult que representan el resultado de la detección para cada equipo de destino para el que se planeó la detección.