Delen via

Invoke-SCXDiscovery

  • Referentie
Module:
OperationsManager

Roept de detectiebewerking aan voor de opgegeven configuratie van UNIX- en Linux-computers.

Syntaxis

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>]

Description

De Invoke-SCXDiscovery cmdlet roept de detectiebewerking aan voor de opgegeven configuratie van UNIX- en Linux-computers.

De bewerking maakt gebruik van een SSH-referentieobject voor bevoegde SSH-installatieacties en een optioneel Windows PowerShell-referentieobject voor communicatie met beperkte bevoegdheden WS-Management agent. Als de agent handmatig is geïnstalleerd op de doelhosts, is alleen de referentie met beperkte bevoegdheden vereist WS-Management.

De uitvoer van deze cmdlet is een matrix van DiscoveryResult objecten die het detectieresultaat vertegenwoordigen voor elke doelcomputer waarvoor detectie is uitgevoerd.

Voorbeelden

Voorbeeld 1: UNIX- en Linux-computers detecteren binnen een bereik van 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

Met de eerste opdracht krijgt u een referentie voor een gebruiker met behulp van de cmdlet Get-Credential. De opdracht vraagt u om verificatie en slaat vervolgens de resultaten op in de $WSCredential variabele.

Met de tweede opdracht maakt u een bevoegde referentie voor een gebruiker met behulp van de cmdlet Get-SCXSSHCredential. Met de opdracht wordt het resultaat opgeslagen in de $SSHCredential variabele.

De derde opdracht haalt een resourcegroep met de naam pool01 op met behulp van de Get-SCOMResourcePool cmdlet en slaat deze vervolgens op in de variabele $Pool 01.

Met de laatste opdracht worden UNIX- en Linux-computers binnen een bereik van IP-adressen gedetecteerd.

Voorbeeld 2: UNIX- en Linux-computers op naam detecteren met een niet-standaardpoort

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

De eerste opdracht haalt een referentie voor een gebruiker op met behulp van Get-Credential. De opdracht vraagt u om verificatie en slaat vervolgens de resultaten op in de $WSCredential variabele.

Met de tweede opdracht maakt u een bevoegde referentie voor een gebruiker met behulp van Get-SCXSSHCredential. Met de opdracht wordt het resultaat opgeslagen in de $SSHCredential variabele.

De derde opdracht haalt een resourcegroep met de naam pool01 op met behulp van Get-SCOMResourcePoolen slaat deze vervolgens op in de variabele $Pool 01.

De laatste opdracht detecteert UNIX- en Linux-computers op naam met behulp van een resourcegroep en het opgeven van een niet-standaard SSH-poort.

Voorbeeld 3: UNIX- en Linux-computers detecteren op naam

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

De eerste opdracht haalt een resourcegroep met de naam RP1 op met behulp van Get-SCOMResourcePoolen slaat deze vervolgens op in de variabele $Pool.

Met de tweede opdracht worden UNIX- en Linux-computers gedetecteerd op naam waarop de beheeragent al is geïnstalleerd.

Parameters

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet actief zijn op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Typ Get-Help Get-Credentialvoor meer informatie over referentieobjecten.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IPRange

Hiermee geeft u een bereik van IP-adressen die worden gebruikt voor detectie. De IPRange- moet twee IP-adressen bevatten (bijvoorbeeld 192.168.0.1.192.168.0.254). De parameters IPRange of Name moeten worden opgegeven.

Type:IPAddress[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een lijst met geldige hostnamen, FQDN's of IP-adressen op (gescheiden door een komma) die wordt gebruikt voor detectie. De parameters IPRange of Name moeten worden opgegeven. Deze parameter wordt geaccepteerd vanuit de pijplijn.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourcePool

Hiermee geeft u een resourcegroep van servers, waarvan een is toegewezen aan de huidige beheerserver en de andere als back-upbeheerservers. Voor deze parameter is een resourcegroepobject vereist en worden alleen de beheerde computers in die resourcegroep geretourneerd.

Typ Get-Help Get-SCOMResourcePoolvoor informatie over het ophalen van een resourcegroepobject.

Type:ManagementServicePool
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Gebruik de cmdlet Get-SCOMManagementGroupConnection om Connection-objecten op te halen.

Als deze parameter niet is opgegeven, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SshCredential

Hiermee geeft u een bevoegde SSH-referentie die wordt gebruikt om de agentinstallatieacties uit te voeren. Als deze parameter niet is opgegeven, mislukt de detectie, tenzij een agent handmatig is geïnstalleerd op de doelcomputer.

Typ Get-Help Get-SCXSSHCredentialvoor informatie over het ophalen van een SSH-referentieobject.

Type:CredentialSet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SshPort

Hiermee geeft u de poort die moet worden gebruikt voor SSH-communicatie met de host. Als dit niet is opgegeven, wordt de standaardwaarde van 22 gebruikt.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WsManCredential

Hiermee geeft u een referentie op die wordt gebruikt voor communicatie met beperkte bevoegdheden via WS-Management.

Typ een gebruikersnaam, zoals User01 of voer een PSCredential--object in, zoals een object dat wordt geretourneerd door de Get-Credential-cmdlet. Wanneer u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord. Typ Get-Help Get-Credentialvoor meer informatie.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

DiscoveryResult

Deze cmdlet retourneert een matrix van DiscoveryResult-objecten die het detectieresultaat vertegenwoordigen voor elke doelcomputer waarvoor detectie is gepland.