Freigeben über

Invoke-SCXDiscovery

  • Referenz
Modul:
OperationsManager

Ruft den Ermittlungsvorgang für die angegebene Konfiguration von UNIX- und Linux-Computern auf.

Syntax

Invoke-SCXDiscovery
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      -Name <String[]>
      -ResourcePool <ManagementServicePool>
      [-SshPort <Int32>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [<CommonParameters>]
Invoke-SCXDiscovery
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      -ResourcePool <ManagementServicePool>
      -IPRange <IPAddress[]>
      [-SshPort <Int32>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [<CommonParameters>]

Beschreibung

Das cmdlet Invoke-SCXDiscovery ruft den Ermittlungsvorgang für die angegebene Konfiguration von UNIX- und Linux-Computern auf.

Der Vorgang verwendet ein SSH-Anmeldeinformationsobjekt für privilegierte SSH-Installationsaktionen und ein optionales Windows PowerShell-Anmeldeinformationsobjekt für die Kommunikation mit Agent mit niedriger Berechtigung WS-Management Agent. Wenn der Agent manuell auf den Zielhosts installiert wurde, ist nur die berechtigungsarme WS-Management Anmeldeinformationen erforderlich.

Die Ausgabe dieses Cmdlets ist ein Array von DiscoveryResult- Objekten, die das Ermittlungsergebnis für jeden Zielcomputer darstellen, für den die Ermittlung versucht wurde.

Beispiele

Beispiel 1: Ermitteln von UNIX- und Linux-Computern innerhalb eines Bereichs von IP-Adressen

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

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 mithilfe des cmdlets Get-SCOMResourcePool einen Ressourcenpool mit dem Namen "pool01" ab und speichert ihn dann in der Variablen $Pool 01.

Der letzte Befehl ermittelt UNIX- und Linux-Computer innerhalb eines Bereichs von IP-Adressen.

Beispiel 2: Ermitteln von UNIX- und Linux-Computern anhand eines Namens mit einem nicht standardmäßigen Port

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

Der erste Befehl ruft mithilfe von Get-Credentialeine Anmeldeinformation für einen Benutzer ab. Die Eingabeaufforderungen für die Authentifizierung und speichern dann die Ergebnisse in der variablen $WSCredential.

Mit dem zweiten Befehl werden privilegierte Anmeldeinformationen für einen Benutzer mithilfe Get-SCXSSHCredential-erstellt. Der Befehl speichert das Ergebnis in der variablen $SSHCredential.

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

Der letzte Befehl ermittelt UNIX- und Linux-Computer anhand eines Ressourcenpools und gibt einen nicht standardmäßigen SSH-Port an.

Beispiel 3: Ermitteln von UNIX- und Linux-Computern anhand des Namens

PS C:\>$Pool = Get-SCOMResourcePool "RP1"
PS C:\> Invoke-SCXDiscovery -Name "nx1.contoso.com,nx2.contoso.com,nx3.contoso.com" -ResourcePool $Pool -WSManCredential "DavidChew"

Der erste Befehl ruft einen Ressourcenpool namens RP1 mithilfe Get-SCOMResourcePool-ab und speichert ihn dann in der $Pool Variablen.

Der zweite Befehl ermittelt UNIX- und Linux-Computer anhand des Namens, auf dem der Verwaltungs-Agent bereits installiert wurde.

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.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IPRange

Gibt einen Bereich von IP-Adressen an, der für die Ermittlung verwendet wird. Die IPRange- muss zwei IP-Adressen enthalten (z. B. 192.168.0.1,192.168.0.254). Entweder die parameter IPRange oder Name Parameter müssen angegeben werden.

Typ:IPAddress[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt eine Liste gültiger Hostnamen, FQDNs oder IP-Adressen (getrennt durch ein Komma) an, die für die Ermittlung verwendet werden. Entweder die parameter IPRange oder Name Parameter müssen angegeben werden. Dieser Parameter wird von der Pipeline akzeptiert.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourcePool

Gibt einen Ressourcenpool von Servern an, von denen einer dem aktuellen Verwaltungsserver und den anderen als Sicherungsverwaltungsservern zugewiesen ist. Dieser Parameter erfordert ein Ressourcenpoolobjekt und gibt nur die verwalteten Computer in diesem Ressourcenpool zurück.

Geben Sie Get-Help Get-SCOMResourcePoolein, um Informationen zum Abrufen eines Ressourcenpoolobjekts zu erhalten.

Typ:ManagementServicePool
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SshCredential

Gibt eine privilegierte SSH-Anmeldeinformationen an, die zum Ausführen der Agentinstallationsaktionen verwendet werden. Wenn dieser Parameter nicht angegeben ist, schlägt die Ermittlung fehl, es sei denn, ein Agent wurde manuell auf dem Zielcomputer installiert.

Um Informationen zum Abrufen eines SSH-Anmeldeinformationsobjekts zu erhalten, geben Sie Get-Help Get-SCXSSHCredentialein.

Typ:CredentialSet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SshPort

Gibt den Port an, der für die SSH-Kommunikation mit dem Host verwendet werden soll. Wenn nicht angegeben, wird der Standardwert von 22 verwendet.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WsManCredential

Gibt eine Anmeldeinformation an, die für die Kommunikation mit Agent mit niedriger Berechtigung über WS-Management verwendet wird.

Geben Sie einen Benutzernamen ein, z. B. "User01", oder geben Sie ein PSCredential--Objekt ein, z. B. ein Objekt, das vom Cmdlet Get-Credential zurückgegeben wird. Wenn Sie einen Benutzernamen eingeben, werden Sie aufgefordert, ein Kennwort einzugeben. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

DiscoveryResult

Dieses Cmdlet gibt ein Array von DiscoveryResult- -Objekten zurück, die das Ermittlungsergebnis für jeden Zielcomputer darstellen, für den die Ermittlung geplant wurde.