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 Anmeldeinformationenobjekt für die Kommunikation mit niedriger privilegierten WS-Management Agent. Wenn der Agent manuell auf den gezielten Hosts installiert wurde, ist nur die WS-Management Anmeldeinformationen mit niedriger Privilegierten 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: Entdecken von UNIX- und Linux-Computern in einem Bereich 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 dann die Ergebnisse in der $WSCredential Variable.
Der zweite Befehl erstellt eine privilegierte Anmeldeinformationen für einen Benutzer mithilfe des Cmdlets Get-SCXSSHCredential. 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 $Pool 01-Variable.
Der letzte Befehl erkennt UNIX- und Linux-Computer innerhalb eines Bereichs von IP-Adressen.
Beispiel 2: Entdecken Sie UNIX- und Linux-Computer nach Namen 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 dann die Ergebnisse in der $WSCredential Variable.
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 $Pool 01-Variable.
Der endgültige Befehl erkennt UNIX- und Linux-Computer anhand eines Ressourcenpools und gibt einen nicht standardmäßigen SSH-Port an.
Beispiel 3: Entdecken 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 nach Namen, auf denen der Verwaltungs-Agent bereits installiert wurde.
Parameter
-ComputerName
Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers 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 Get-Credential-Cmdlet zurückgibt, für diesen Parameter.
Weitere Informationen zu Anmeldeinformationenobjekten geben Sie Get-Help Get-Credentialein.
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. Die 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 der gültigen 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 aus 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 wird dem aktuellen Verwaltungsserver und den anderen, die als Sicherungsverwaltungsserver dienen, zugewiesen. Dieser Parameter erfordert ein Ressourcenpoolobjekt und gibt nur die verwalteten Computer in diesem Ressourcenpool zurück.
Informationen zum Abrufen eines Ressourcenpoolobjekts finden Sie unter ".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. Um Verbindungsobjekte abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection .
Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe.
Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben.
Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden.
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-Anmeldeinformationenobjekts finden Sie Get-Help Get-SCXSSHCredentialunter ".
| 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 Anmeldeinformationen an, die für die Kommunikation mit niedrig privilegiertem Agent über WS-Management verwendet werden.
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 Zielcomputer darstellt, für den die Ermittlung geplant wurde.