Partilhar via

Invoke-SCXDiscovery

  • Referência
Módulo:
OperationsManager

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

A operação utiliza um objeto credencial SSH para ações privilegiadas de instalação de SSH e um objeto credencial Windows PowerShell opcional para comunicação de agentes de WS-Management privilegiados. Se o agente tiver sido instalado manualmente nos anfitriões-alvo, apenas é necessária a credencial de WS-Management privilegiada.

A saída deste cmdlet é uma variedade de objetos DiscoveryResult que representam o resultado da descoberta de cada computador alvo para o qual a descoberta foi tentada.

Exemplos

Exemplo 1: Descubra os computadores UNIX e Linux dentro de uma gama 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 utilizador utilizando o Get-Credential cmdlet. O comando solicita a autenticação e, em seguida, armazena os resultados na variável $WSCredential.

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

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

O comando final descobre computadores UNIX e Linux dentro de uma gama de endereços IP.

Exemplo 2: Descubra os 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 utilizador usando o Get-Credential. O comando solicita a autenticação e, em seguida, armazena os resultados na variável $WSCredential.

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

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

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

Exemplo 3: Descubra os computadores UNIX e Linux pelo 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 conjunto de recursos chamado RP1 usando Get-SCOMResourcePool, e depois armazena-o na variável $Pool.

O segundo comando descobre computadores UNIX e Linux pelo nome onde o agente de gestão já foi instalado.

Parâmetros

-ComputerName

Especifica uma série de nomes de computadores. O cmdlet estabelece ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio totalmente qualificados (FQDNs). Para especificar o computador local, digite o nome do computador, local local ou um ponto (.).

O serviço de Acesso a Dados do Centro de Sistemas deve estar ativo no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.

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

-Credential

Especifica a conta de utilizador sob a qual a ligação do grupo de gestão é executado. Especifique um objeto PSCredential , tal como aquele que o cmdlet Get-Credential devolve, para este parâmetro. Para obter mais informações sobre objetos credenciais, escreva Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

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

-IPRange

Especifica uma gama de endereços IP que serão utilizados para a 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 anfitriões válidos, FQDNs ou endereços IP (separados por uma vírgula) que serão usados para a descoberta. Os parâmetros IPRange ou Name devem ser especificados. Este parâmetro é aceite a partir do oleoduto.

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

-ResourcePool

Especifica um conjunto de recursos de servidores, um dos quais é designado para ser o servidor de gestão atual e os outros que servem como servidores de gestão de backup. Este parâmetro requer um objeto de piscina de recursos e devolve apenas os computadores geridos nesse conjunto de recursos.

Para obter informações sobre como obter um objeto de piscina de recursos, escreva 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 de ligação . Para obter objetos de ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Se este parâmetro não for especificado, o cmdlet utiliza a ligação persistente ativa a um grupo de gestão. Utilize o parâmetro SCSession para especificar uma ligação persistente diferente. Pode criar uma ligação temporária a um grupo de gestão utilizando os parâmetros ComputerName e Credential . Para mais informações, insira 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 este parâmetro não for especificado, a descoberta falha a menos que um agente tenha sido instalado manualmente no computador visado.

Para obter informações sobre como obter um objeto credencial SSH, escreva 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 utilizar para comunicação SSH com o hospedeiro. Se não for especificado, utiliza-se o valor predefinido de 22.

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 agentes de baixos privilégios através da WS-Management.

Digite um nome de utilizador, como Utilizador01 ou introduza um objeto PSCredential , tal como um que é devolvido pelo Get-Credential cmdlet. Quando escreve um nome de utilizador, é-lhe solicitada uma palavra-passe. Para mais informações, insira Get-Help Get-Credential.

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

Saídas

DiscoveryResult

Este cmdlet devolve uma série de objetos DiscoveryResult que representam o resultado da descoberta de cada computador alvo para o qual a descoberta foi planeada.