Compartilhar via

Invoke-SCXDiscovery

  • Referência
Módulo:
OperationsManager

Invoca a operação de descoberta para a configuração especificada de computadores UNIX e 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

O cmdlet Invoke-SCXDiscovery invoca a operação de descoberta para a configuração especificada de computadores UNIX e Linux.

A operação usa um objeto de credencial SSH para ações de instalação de SSH com privilégios e um objeto de credencial Windows PowerShell opcional para comunicação de agente de WS-Management com privilégios baixos. Se o agente tiver sido instalado manualmente nos hosts de destino, somente a credencial de WS-Management de baixo privilégio será necessária.

A saída desse cmdlet é uma matriz de objetos DiscoveryResult que representam o resultado da descoberta para cada computador de destino para o qual a descoberta foi tentada.

Exemplos

Exemplo 1: descobrir computadores UNIX e Linux em um intervalo de endereços 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

O primeiro comando obtém uma credencial para um usuário usando o cmdlet Get-Credential. O comando solicita autenticação e armazena os resultados na variável $WSCredential.

O segundo comando cria uma credencial privilegiada para um usuário usando o cmdlet Get-SCXSSHCredential. O comando armazena o resultado na variável $SSHCredential.

O terceiro comando obtém um pool de recursos chamado pool01 usando o cmdlet Get-SCOMResourcePool e o armazena na variável $Pool 01.

O comando final descobre computadores UNIX e Linux em um intervalo de endereços IP.

Exemplo 2: descobrir computadores UNIX e Linux pelo nome com uma porta não padrão

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

O primeiro comando obtém uma credencial para um usuário usando Get-Credential. O comando solicita autenticação e armazena os resultados na variável $WSCredential.

O segundo comando cria uma credencial privilegiada para um usuário usando Get-SCXSSHCredential. O comando armazena o resultado na variável $SSHCredential.

O terceiro comando obtém um pool de recursos chamado pool01 usando Get-SCOMResourcePool e, em seguida, armazena-o na variável $Pool 01.

O comando final descobre computadores UNIX e Linux pelo nome usando um pool de recursos e especificando uma porta SSH não padrão.

Exemplo 3: descobrir computadores UNIX e Linux por nome

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

O primeiro comando obtém um pool de recursos chamado RP1 usando Get-SCOMResourcePool e, em seguida, armazena-o na variável $Pool.

O segundo comando descobre computadores UNIX e Linux pelo nome em que o agente de gerenciamento já foi instalado.

Parâmetros

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes netbios, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center deve estar ativo no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.

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

-Credential

Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada. Especifique um objeto PSCredential , como um que o cmdlet Get-Credential retorna, para esse parâmetro. Para obter mais informações sobre objetos de credencial, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName , use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

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

-IPRange

Especifica um intervalo de endereços IP que serão usados para descoberta. O IPRange deve conter dois endereços IP (por exemplo, 192.168.0.1.192.168.0.254). Os parâmetros IPRange ou Name devem ser especificados.

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

-Name

Especifica uma lista de nomes de host válidos, FQDNs ou Endereços IP (separados por uma vírgula) que serão usados para descoberta. Os parâmetros IPRange ou Name devem ser especificados. Esse parâmetro é aceito no pipeline.

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

-ResourcePool

Especifica um pool de recursos de servidores, um dos quais é atribuído para ser o servidor de gerenciamento atual e os outros que servem como servidores de gerenciamento de backup. Esse parâmetro requer um objeto de pool de recursos e retorna apenas os computadores gerenciados nesse pool de recursos.

Para obter informações sobre como obter um objeto de pool de recursos, digite Get-Help Get-SCOMResourcePool.

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

-SCSession

Especifica uma matriz de objetos Connection . Para obter objetos Connection , use o cmdlet Get-SCOMManagementGroupConnection .

Se esse parâmetro não for especificado, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential . Para obter mais informações, digite Get-Help about_OpsMgr_Connections.

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

-SshCredential

Especifica uma credencial SSH privilegiada usada para executar as ações de instalação do agente. Se esse parâmetro não for especificado, a descoberta falhará, a menos que um agente tenha sido instalado manualmente no computador de destino.

Para obter informações sobre como obter um objeto de credencial SSH, digite Get-Help Get-SCXSSHCredential.

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

-SshPort

Especifica a porta a ser usada para comunicação SSH com o host. Se não for especificado, o valor padrão de 22 será usado.

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

-WsManCredential

Especifica uma credencial usada para comunicação de agente de baixo privilégio por meio do WS-Management.

Digite um nome de usuário, como User01 ou insira um objeto PSCredential , como um que é retornado pelo cmdlet Get-Credential. Quando você digitar um nome de usuário, uma senha será solicitada. Para obter mais informações, digite Get-Help Get-Credential.

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

Saídas

DiscoveryResult

Esse cmdlet retorna uma matriz de objetos DiscoveryResult que representam o resultado da descoberta para cada computador de destino para o qual a descoberta foi planejada.