Partilhar via

Install-SCXAgent

Módulo:
OperationsManager Module

Instala o agente do Operations Manager para computadores UNIX e Linux descobertos.

Sintaxe

Default (Predefinição) 

Install-SCXAgent
    -DiscoveryResult <DiscoveryResult[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Install-SCXAgent instala o agente do Operations Manager para computadores UNIX e Linux descobertos, assina o certificado para comunicação WS-Management e registra o agente no Operations Manager para gerenciamento. Computadores UNIX e Linux devem ser descobertos com o cmdlet Invoke-SCXDiscovery. O objeto de saída do cmdlet Invoke-SCXDiscovery é fornecido como a entrada DiscoveryResult para o cmdlet Install-SCXAgent.

Para obter informações sobre como descobrir computadores UNIX ou Linux, digite Get-Help Invoke-SCXDiscovery.

Este cmdlet retorna uma matriz de objetos de computador UNIX ou Linux gerenciados que representam os sistemas de destino que foram instalados com êxito.

Exemplos

Exemplo 1: Descubra computadores UNIX e Linux e instale o agente de gerenciamento

PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "Pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $MyPool -WSManCredential $WSCredential -SSHCredential $SSHCredential | Install-SCXAgent

O primeiro comando obtém uma credencial para um usuário usando o cmdlet Get-Credential. O comando solicita autenticação e, em seguida, 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 invoca uma descoberta de computadores UNIX e Linux dentro de um intervalo de endereços IP usando o cmdlet Invoke-SCXDiscovery. O comando passa todos os computadores descobertos para o cmdlet atual usando o operador de pipeline. O comando instala o agente de gerenciamento.

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 atual do grupo de gerenciamento.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Credential

Especifica a conta de usuário sob a 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 dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DiscoveryResult

Especifica a objeto DiscoveryResult processar para a instalação do agente de gerenciamento, conforme retornado pelo cmdlet Invoke-SCXDiscovery .

Para obter mais informações sobre como descobrir sistemas de destino, digite Get-Help Invoke-SCXDiscovery.

Propriedades dos parâmetros

Tipo:

DiscoveryResult[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:

Connection[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Microsoft.Unix.Computer

Este cmdlet retorna uma matriz de computadores UNIX e Linux gerenciados que foram instalados com êxito.