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 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
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
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 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.