Compartilhar via


Invoke-SCXDiscovery

Invoca a operação de descoberta para a configuração especificada de computadores UNIX e Linux.

Sintaxe

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

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 opcional do Windows PowerShell 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 dentro de 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-SCOMResourcePoole o armazena 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 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 pool de recursos chamado RP1 usando Get-SCOMResourcePool e o armazena 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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.1.192.168.0.254). Os parâmetros IPRange ou Name devem ser especificados.

Propriedades do parâmetro

Tipo:

IPAddress[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromIPRangeAndResourcePoolParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do pipeline.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromHostNameAndResourcePoolParameterSetName
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourcePool

Especifica um pool de recursos de servidores, um dos quais é atribuído a 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 do pool de recursos, digite Get-Help Get-SCOMResourcePool.

Propriedades do parâmetro

Tipo:ManagementServicePool
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:

Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:CredentialSet
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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ê digita um nome de usuário, você é solicitado a obter uma senha. Para obter mais informações, digite Get-Help Get-Credential.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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.