Sdílet prostřednictvím

Invoke-SCXDiscovery

  • Reference
Modul:
OperationsManager

Vyvolá operaci zjišťování pro zadanou konfiguraci počítačů se systémy UNIX a Linux.

Syntaxe

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

Rutina Invoke-SCXDiscovery vyvolá operaci zjišťování pro zadanou konfiguraci počítačů se systémy UNIX a Linux.

Operace používá objekt přihlašovacích údajů SSH pro privilegované akce instalace SSH a volitelný objekt přihlašovacích údajů Windows PowerShellu pro komunikaci s agentem s nízkou úrovní oprávnění WS-Management. Pokud je agent ručně nainstalovaný na cílových hostitelích, vyžaduje se pouze málo privilegované WS-Management přihlašovací údaje.

Výstupem této rutiny je pole DiscoveryResult objektů představujících výsledek zjišťování pro každý cílový počítač, pro který se zjišťování pokusilo.

Příklady

Příklad 1: Zjišťování počítačů se systémy UNIX a Linux v rozsahu IP adres

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

První příkaz získá přihlašovací údaje pro uživatele pomocí rutiny Get-Credential. Příkaz vás vyzve k ověření a uloží výsledky do proměnné $WSCredential.

Druhý příkaz vytvoří privilegované přihlašovací údaje pro uživatele pomocí rutiny Get-SCXSSHCredential. Příkaz uloží výsledek do proměnné $SSHCredential.

Třetí příkaz získá fond zdrojů s názvem pool01 pomocí rutiny Get-SCOMResourcePool a uloží ho do proměnné $Pool 01.

Poslední příkaz zjistí počítače se systémy UNIX a Linux v rozsahu IP adres.

Příklad 2: Zjištění počítačů se systémem UNIX a Linux podle názvu s nestandardním portem

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

První příkaz získá přihlašovací údaje pro uživatele pomocí Get-Credential. Příkaz vás vyzve k ověření a uloží výsledky do proměnné $WSCredential.

Druhý příkaz vytvoří privilegované přihlašovací údaje pro uživatele pomocí Get-SCXSSHCredential. Příkaz uloží výsledek do proměnné $SSHCredential.

Třetí příkaz získá fond zdrojů s názvem pool01 pomocí Get-SCOMResourcePoola pak ho uloží do proměnné $Pool 01.

Poslední příkaz zjistí počítače se systémem UNIX a Linux pomocí názvu pomocí fondu zdrojů a zadáním nestandardního portu SSH.

Příklad 3: Zjištění počítačů se systémem UNIX a Linux podle názvu

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

První příkaz získá fond zdrojů s názvem RP1 pomocí Get-SCOMResourcePoola pak ho uloží do proměnné $Pool.

Druhý příkaz zjistí počítače se systémy UNIX a Linux podle názvu, ve kterém už je agent pro správu nainstalovaný.

Parametry

-ComputerName

Určuje pole názvů počítačů. Rutina vytvoří dočasná připojení ke skupinám pro správu pro tyto počítače. Můžete použít názvy NetBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).

Služba System Center Data Access musí být v počítači aktivní. Pokud nezadáte počítač, rutina použije počítač pro aktuální připojení skupiny pro správu.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje uživatelský účet, pod kterým běží připojení ke skupině pro správu. Zadejte objekt PSCredential, například objekt, který Rutina Get-Credential vrátí, pro tento parametr. Další informace o objektech pověření zadejte Get-Help Get-Credential.

Pokud zadáte počítač v parametru ComputerName, použijte účet, který má přístup k danému počítači. Výchozí hodnota je aktuální uživatel.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IPRange

Určuje rozsah IP adres, které se použijí ke zjišťování. IPRange musí obsahovat dvě IP adresy (například 192.168.0.1,192.168.0.254). Je třeba zadat parametry IPRange nebo Název.

Typ:IPAddress[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje seznam platných názvů hostitelů, plně kvalifikovaných názvů domén nebo IP adres (oddělených čárkou), které se použijí ke zjišťování. Je třeba zadat parametry IPRange nebo Název. Tento parametr je přijat z kanálu.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourcePool

Určuje fond zdrojů serverů, z nichž jeden je přiřazený jako aktuální server pro správu a druhý, který slouží jako servery pro správu záloh. Tento parametr vyžaduje objekt fondu zdrojů a vrací pouze spravované počítače v tomto fondu zdrojů.

Informace o tom, jak získat objekt fondu zdrojů, zadejte Get-Help Get-SCOMResourcePool.

Typ:ManagementServicePool
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SCSession

Určuje pole objektů Connection. Pokud chcete získat objekty Connection, použijte rutinu Get-SCOMManagementGroupConnection.

Pokud tento parametr není zadaný, rutina použije aktivní trvalé připojení ke skupině pro správu. Pomocí parametru SCSession zadejte jiné trvalé připojení. Dočasné připojení ke skupině pro správu můžete vytvořit pomocí parametrů ComputerName a přihlašovacích údajů. Další informace potřebujete zadáním Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SshCredential

Určuje privilegované přihlašovací údaje SSH použité k provedení akcí instalace agenta. Pokud tento parametr není zadaný, zjišťování selže, pokud není na cílovém počítači ručně nainstalován agent.

Informace o tom, jak získat objekt přihlašovacích údajů SSH, zadejte Get-Help Get-SCXSSHCredential.

Typ:CredentialSet
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SshPort

Určuje port, který se má použít pro komunikaci SSH s hostitelem. Pokud není zadáno, použije se výchozí hodnota 22.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WsManCredential

Určuje přihlašovací údaje používané pro komunikaci s agenty s nízkou úrovní oprávnění prostřednictvím služby WS-Management.

Zadejte uživatelské jméno, například User01, nebo zadejte objekt PSCredential, například objekt vrácený rutinou Get-Credential. Když zadáte uživatelské jméno, zobrazí se výzva k zadání hesla. Další informace potřebujete zadáním Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

DiscoveryResult

Tato rutina vrátí pole DiscoveryResult objektů představujících výsledek zjišťování pro každý cílový počítač, pro který bylo zjišťování naplánováno.