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.

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

Description

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

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

Výstupem této rutiny je pole objektů DiscoveryResult představující 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 pak 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 pak ho uloží 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šťová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 pak 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-SCOMResourcePool a pak ho uloží do proměnné $Pool 01.

Poslední příkaz zjistí počítače se systémem UNIX a Linux podle názvu pomocí fondu zdrojů a určí nestandardní port SSH.

Příklad 3: Zjišťování počítačů se systémy 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-SCOMResourcePool a pak ho uloží do proměnné $Pool.

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

Parametry

-ComputerName

Určuje pole názvů počítačů. Rutina vytvoří dočasná připojení se skupinami 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). Pokud chcete 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Určuje uživatelský účet, pod kterým se spouští připojení skupiny pro správu. Zadejte objekt PSCredential , například objekt, který rutina Get-Credential vrátí pro tento parametr. Další informace o objektech přihlašovacích údajů 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. Ve výchozím nastavení je to aktuální uživatel.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPRange

Určuje rozsah IP adres, které se budou používat ke zjišťování. IpRange musí obsahovat dvě IP adresy (například 192.168.0.1 192.168.0.254). Je nutné zadat parametry IPRange nebo Name .

Type:IPAddress[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourcePool

Určuje fond zdrojů serverů, z nichž jedna má být aktuálním serverem pro správu a dalšími 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.

Type:ManagementServicePool
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Určuje pole objektů připojení . K získání objektů Connection použijte rutinu Get-SCOMManagementGroupConnection .

Pokud tento parametr není zadaný, rutina používá 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 Credential . Další informace zobrazíte zadáním Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SshCredential

Určuje privilegované přihlašovací údaje SSH používané k provádění akcí instalace agenta. Pokud tento parametr není zadán, 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.

Type:CredentialSet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SshPort

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 jeden, který vrací rutina Get-Credential. Když zadáte uživatelské jméno, zobrazí se výzva k zadání hesla. Další informace zobrazíte zadáním Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Výstupy

DiscoveryResult

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