Invoke-SCXDiscovery
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 WS-Management Agent mit niedriger Privilegierter WS-Management. Wenn der Agent manuell auf den gezielten Hosts installiert wurde, ist nur die WS-Management Anmeldeinformationen mit niedriger Privilegierter WS-Management erforderlich.
Die Ausgabe dieses Cmdlets ist ein Array von DiscoveryResult-Objekten , das das Ermittlungsergebnis für jeden Zielcomputer darstellt, 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 $SSHCredentialDer 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 erkennt UNIX- und Linux-Computer innerhalb eines Bereichs von IP-Adressen.
Beispiel 2: Ermitteln von UNIX- und Linux-Computern 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 $SSHCredentialDer erste Befehl ruft eine Anmeldeinformationen für einen Benutzer mithilfe von Get-Credential ab. Der Befehl fordert Sie zur Authentifizierung auf, und speichert die Ergebnisse dann in der $WSCredential Variablen.
Der zweite Befehl erstellt eine privilegierte Anmeldeinformationen für einen Benutzer mithilfe von Get-SCXSSHCredential. Der Befehl speichert das Ergebnis in der $SSHCredential Variablen.
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 erkennt UNIX- und Linux-Computer anhand eines Ressourcenpools und gibt einen nicht standardmäßigen SSH-Port an.
Beispiel 3: Ermitteln von UNIX- und Linux-Computern nach Name
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 von Get-SCOMResourcePool ab und speichert ihn dann in der $Pool Variablen.
Der zweite Befehl erkennt 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 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 |
-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 |
-IPRange
Gibt einen Bereich von IP-Adressen an, die für die Ermittlung verwendet werden. Das IPRange muss zwei IP-Adressen enthalten (z. B. 192.168.0.1,192.168.0.254). Entweder die Parameter "IPRange " oder "Name " müssen angegeben werden.
| Type: | IPAddress[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 " müssen angegeben werden. Dieser Parameter wird von der Pipeline akzeptiert.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourcePool
Gibt einen Ressourcenpool von Servern an, einer davon ist der aktuelle Verwaltungsserver und die anderen, die als Sicherungsverwaltungsserver dienen. Dieser Parameter erfordert ein Ressourcenpoolobjekt und gibt nur die verwalteten Computer in diesem Ressourcenpool zurück.
Informationen zum Abrufen eines Ressourcenpoolobjekts finden Sie im Typ Get-Help Get-SCOMResourcePool.
| Type: | ManagementServicePool |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| 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 |
-SshCredential
Gibt eine privilegierte SSH-Anmeldeinformationen an, die zum Ausführen der Agent-Installationsaktionen verwendet werden. Wenn dieser Parameter nicht angegeben ist, schlägt die Ermittlung fehl, es sei denn, ein Agent wurde manuell auf dem Zielcomputer installiert.
Informationen zum Abrufen eines SSH-Anmeldeinformationsobjekts geben Sie Get-Help Get-SCXSSHCredential.
| Type: | CredentialSet |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WsManCredential
Gibt eine Anmeldeinformation an, die für die Kommunikation mit einem niedrigeren Privilegierten Agent ü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 zur Eingabe eines Kennworts aufgefordert.
Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Ausgaben
DiscoveryResult
Dieses Cmdlet gibt ein Array von DiscoveryResult-Objekten zurück, das das Ermittlungsergebnis für jeden zielbezogenen Computer darstellt, für den die Ermittlung geplant wurde.