Udostępnij za pośrednictwem

Invoke-SCXDiscovery

  • Odwołanie
Moduł:
OperationsManager

Wywołuje operację odnajdywania dla określonej konfiguracji komputerów z systemami UNIX i Linux.

Składnia

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

Opis

Polecenie cmdlet Invoke-SCXDiscovery wywołuje operację odnajdywania dla określonej konfiguracji komputerów z systemami UNIX i Linux.

Operacja używa obiektu poświadczeń SSH dla uprzywilejowanych akcji instalacji SSH i opcjonalnego obiektu poświadczeń programu Windows PowerShell na potrzeby komunikacji z agentem z niskimi uprawnieniami WS-Management. Jeśli agent został zainstalowany ręcznie na hostach docelowych, wymagane jest tylko poświadczenie WS-Management o niskich uprawnieniach.

Dane wyjściowe tego polecenia cmdlet to tablica obiektów DiscoveryResult reprezentujących wynik odnajdywania dla każdego komputera docelowego, dla którego podjęto próbę odnajdywania.

Przykłady

Przykład 1: Odnajdywanie komputerów z systemami UNIX i Linux w zakresie adresów IP

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

Pierwsze polecenie pobiera poświadczenia dla użytkownika przy użyciu polecenia cmdlet Get-Credential. Polecenie wyświetla monit o uwierzytelnienie, a następnie zapisuje wyniki w zmiennej $WSCredential.

Drugie polecenie tworzy uprzywilejowane poświadczenie dla użytkownika przy użyciu polecenia cmdlet Get-SCXSSHCredential. Polecenie przechowuje wynik w zmiennej $SSHCredential.

Trzecie polecenie pobiera pulę zasobów o nazwie pool01 przy użyciu polecenia cmdlet Get-SCOMResourcePool, a następnie zapisuje je w zmiennej $Pool 01.

Ostatnie polecenie umożliwia odnalezienie komputerów z systemami UNIX i Linux w zakresie adresów IP.

Przykład 2. Odnajdywanie komputerów z systemami UNIX i Linux według nazwy z niestandardowym 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

Pierwsze polecenie pobiera poświadczenia dla użytkownika przy użyciu Get-Credential. Polecenie wyświetla monit o uwierzytelnienie, a następnie zapisuje wyniki w zmiennej $WSCredential.

Drugie polecenie tworzy uprzywilejowane poświadczenia dla użytkownika przy użyciu Get-SCXSSHCredential. Polecenie przechowuje wynik w zmiennej $SSHCredential.

Trzecie polecenie pobiera pulę zasobów o nazwie pool01 przy użyciu Get-SCOMResourcePool, a następnie zapisuje ją w zmiennej $Pool 01.

Ostatnie polecenie umożliwia odnalezienie komputerów z systemami UNIX i Linux przy użyciu puli zasobów i określenie niestandardowego portu SSH.

Przykład 3. Odnajdywanie komputerów z systemami UNIX i Linux według nazwy

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

Pierwsze polecenie pobiera pulę zasobów o nazwie RP1 przy użyciu Get-SCOMResourcePool, a następnie zapisuje ją w zmiennej $Pool.

Drugie polecenie odnajduje komputery z systemami UNIX i Linux według nazwy, w której zainstalowano już agenta zarządzania.

Parametry

-ComputerName

Określa tablicę nazw komputerów. Polecenie cmdlet ustanawia tymczasowe połączenia z grupami zarządzania dla tych komputerów. Można użyć nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).

Usługa System Center Data Access musi być aktywna na komputerze. Jeśli komputer nie zostanie określony, polecenie cmdlet używa komputera dla bieżącego połączenia grupy zarządzania.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Określa konto użytkownika, w ramach którego jest uruchamiane połączenie grupy zarządzania. Określ obiekt PSCredential, taki jak obiekt polecenia cmdlet Get-Credential zwracany dla tego parametru. Aby uzyskać więcej informacji na temat obiektów poświadczeń, wpisz Get-Help Get-Credential.

Jeśli określisz komputer w parametrze ComputerName, użyj konta, które ma dostęp do tego komputera. Wartość domyślna to bieżący użytkownik.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IPRange

Określa zakres adresów IP, które będą używane do odnajdywania. IPRange musi zawierać dwa adresy IP (na przykład 192.168.0.1,192.168.0.254). Należy określić parametry IPRange lub Name.

Typ:IPAddress[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa listę prawidłowych nazw hostów, nazw FQDN lub adresów IP (oddzielonych przecinkami), które będą używane do odnajdywania. Należy określić parametry IPRange lub Name. Ten parametr jest akceptowany z potoku.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourcePool

Określa pulę zasobów serwerów, z których jeden jest przypisany do bieżącego serwera zarządzania, a pozostałe pełnią rolę serwerów zarządzania kopiami zapasowymi. Ten parametr wymaga obiektu puli zasobów i zwraca tylko zarządzane komputery w tej puli zasobów.

Aby uzyskać informacje o sposobie uzyskiwania obiektu puli zasobów, wpisz Get-Help Get-SCOMResourcePool.

Typ:ManagementServicePool
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SCSession

Określa tablicę obiektów połączenia . Aby uzyskać obiekty połączenia , użyj polecenia cmdlet Get-SCOMManagementGroupConnection.

Jeśli ten parametr nie zostanie określony, polecenie cmdlet używa aktywnego trwałego połączenia z grupą zarządzania. Użyj parametru SCSession, aby określić inne trwałe połączenie. Możesz utworzyć tymczasowe połączenie z grupą zarządzania przy użyciu parametrów ComputerName i Credential. Aby uzyskać więcej informacji, wpisz Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SshCredential

Określa uprzywilejowane poświadczenia SSH używane do wykonywania akcji instalacji agenta. Jeśli ten parametr nie zostanie określony, odnajdywanie zakończy się niepowodzeniem, chyba że agent został ręcznie zainstalowany na komputerze docelowym.

Aby uzyskać informacje o sposobie uzyskiwania obiektu poświadczeń SSH, wpisz Get-Help Get-SCXSSHCredential.

Typ:CredentialSet
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SshPort

Określa port używany do komunikacji SSH z hostem. Jeśli nie zostanie określony, zostanie użyta wartość domyślna 22.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WsManCredential

Określa poświadczenia używane do komunikacji z agentem o niskich uprawnieniach za pośrednictwem usługi WS-Management.

Wpisz nazwę użytkownika, taką jak User01 lub wprowadź obiekt PSCredential, taki jak obiekt zwracany przez polecenie cmdlet Get-Credential. Podczas wpisywania nazwy użytkownika zostanie wyświetlony monit o podanie hasła. Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

DiscoveryResult

To polecenie cmdlet zwraca tablicę obiektów DiscoveryResult reprezentujących wynik odnajdywania dla każdego komputera docelowego, dla którego zaplanowano odnajdywanie.