Install-SCXAgent

  • Referenz
Modul:
OperationsManager

Installiert den Operations Manager-Agent für erkannte UNIX- und Linux-Computer.

Syntax

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

Beschreibung

Das Cmdlet Install-SCXAgent installiert den Operations Manager-Agent für erkannte UNIX- und Linux-Computer, signiert das Zertifikat für WS-Management Kommunikation und registriert den Agent bei Operations Manager für die Verwaltung. UNIX- und Linux-Computer sollten mit dem Cmdlet Invoke-SCXDiscovery ermittelt werden. Das Ausgabeobjekt des Cmdlets Invoke-SCXDiscovery wird als DiscoveryResult-Eingabe für das Cmdlet Install-SCXAgent bereitgestellt.

Um Informationen zum Ermitteln von UNIX- oder Linux-Computern zu erhalten, geben Sie Get-Help Invoke-SCXDiscovery ein.

Dieses Cmdlet gibt ein Array von verwalteten UNIX- oder Linux-Computerobjekten zurück, die die zielbezogenen Systeme darstellen, die erfolgreich installiert wurden.

Beispiele

Beispiel 1: Ermitteln von UNIX- und Linux-Computern und Installieren des Verwaltungs-Agents

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

Der erste Befehl ruft eine Anmeldeinformationen für einen Benutzer mithilfe des Cmdlets Get-Credential ab. Der Befehl fordert Sie zur Authentifizierung auf, und speichert die Ergebnisse dann in der $WSCredential Variablen.

Der zweite Befehl erstellt mithilfe des Cmdlets Get-SCXSSHCredential eine privilegierte Anmeldeinformationen für einen Benutzer. Der Befehl speichert das Ergebnis in der $SSHCredential Variablen.

Der dritte Befehl ruft einen Ressourcenpool namens Pool01 mithilfe des Cmdlets Get-SCOMResourcePool ab und speichert ihn dann in der variablen $Pool 01.

Der letzte Befehl ruft eine Ermittlung von UNIX- und Linux-Computern innerhalb eines Bereichs von IP-Adressen mithilfe des Cmdlets Invoke-SCXDiscovery auf. Der Befehl übergibt alle ermittelten Computer mithilfe des Pipelineoperators an das aktuelle Cmdlet. Der Befehl installiert den Verwaltungs-Agent.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer aktiv sein. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Cmdlet Get-Credential zurückgibt, für diesen Parameter. Geben Sie weitere Informationen zu Anmeldeinformationenobjekten ein Get-Help Get-Credential.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

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

-DiscoveryResult

Gibt das DiscoveryResult-Objekt an, das für die Verwaltungs-Agent-Installation verarbeitet werden soll, wie vom Cmdlet Invoke-SCXDiscovery zurückgegeben.

Weitere Informationen zum Ermitteln gezielter Systeme finden Sie im Typ Get-Help Invoke-SCXDiscovery.

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

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen von Connection-Objekten das Cmdlet Get-SCOMManagementGroupConnection.

Wenn dieser Parameter nicht angegeben ist, verwendet das Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe mithilfe der Parameter "ComputerName " und "Anmeldeinformationen " erstellen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

Microsoft.Unix.Computer[]

Dieses Cmdlet gibt ein Array von verwalteten UNIX- und Linux-Computern zurück, die erfolgreich installiert wurden.