Install-SCXAgent
Installiert den Operations Manager-Agent für ermittelte UNIX- und Linux-Computer.
Syntax
Default (Standardwert)
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 ermittelte 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 finden, geben Sie Get-Help Invoke-SCXDiscovery ein.
Dieses Cmdlet gibt ein Array verwalteter UNIX- oder Linux-Computerobjekte zurück, die die erfolgreich installierten Zielsysteme darstellen.
Beispiele
Beispiel 1: Entdecken Sie UNIX- und Linux-Computer, und installieren Sie den Verwaltungs-Agent.
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 mithilfe des Cmdlets Get-Credential eine Anmeldeinformationen für einen Benutzer ab. Die Eingabeaufforderungen für die Authentifizierung und speichern dann die Ergebnisse in der variablen $WSCredential.
Der zweite Befehl erstellt mithilfe des Cmdlets Get-SCXSSHCredential eine privilegierte Anmeldeinformationen für einen Benutzer. Der Befehl speichert das Ergebnis in der variablen $SSHCredential.
Der dritte Befehl ruft einen Ressourcenpool mit dem Namen Pool01 mithilfe des cmdlets Get-SCOMResourcePool ab und speichert ihn dann in der Variablen $Pool 01.
Der letzte Befehl ruft mithilfe des Cmdlets Invoke-SCXDiscovery eine Ermittlung von UNIX- und Linux-Computern innerhalb eines Bereichs von IP-Adressen 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 richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird.
Geben Sie für diesen Parameter ein PSCredential--Objekt an, z. B. ein Objekt, das vom Get-Credential--Cmdlet zurückgegeben wird.
Wenn Sie weitere Informationen zu Anmeldeinformationsobjekten wünschen, geben Sie Get-Help Get-Credentialein.
Wenn Sie einen Computer im parameter ComputerName angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DiscoveryResult
Gibt das DiscoveryResult--Objekt an, das für die Installation des Verwaltungs-Agents verarbeitet werden soll, wie vom Cmdlet Invoke-SCXDiscovery zurückgegeben.
Wenn Sie weitere Informationen zum Ermitteln gezielter Systeme wünschen, geben Sie Get-Help Invoke-SCXDiscoveryein.
Parametereigenschaften
| Typ: | DiscoveryResult[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SCSession
Gibt ein Array von Connection -Objekten an. Um Connection-Objekte abzurufen, verwenden Sie 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 erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden.
Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.
Parametereigenschaften
| Typ: | Connection[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
Microsoft.Unix.Computer
Dieses Cmdlet gibt ein Array verwalteter UNIX- und Linux-Computer zurück, die erfolgreich installiert wurden.