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ń Windows PowerShell do komunikacji z agentem WS-Management o niskich uprawnieniach. 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świadczenia 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 ją 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 przy użyciu portu innego niż standardowy

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 polecenia 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 polecenia Get-SCXSSHCredential. Polecenie przechowuje wynik w zmiennej $SSHCredential.

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

Ostatnie polecenie odnajduje komputery z systemami UNIX i Linux przy użyciu puli zasobów i określa niestandardowy port 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 polecenia 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 agent zarządzania został już zainstalowany.

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żyje komputera dla bieżącego połączenia grupy zarządzania.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 zwracany przez polecenie cmdlet Get-Credential 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 użytkownik bieżący.

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

-IPRange

Określa zakres adresów IP, które będą używane do odnajdywania. Element 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 .

Type:IPAddress[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:ManagementServicePool
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 polecenie Get-Help about_OpsMgr_Connections.

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

-SshCredential

Określa uprzywilejowane poświadczenia SSH używane do wykonywania akcji instalacji agenta. Jeśli ten parametr nie zostanie określony, odnajdywanie nie powiedzie się, 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.

Type:CredentialSet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WsManCredential

Określa poświadczenia używane do komunikacji z agentem o niskim poziomie uprawnień za pośrednictwem usługi WS-Management.

Wpisz nazwę użytkownika, taką jak User01 lub wprowadź obiekt PSCredential , taki jak 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 polecenie Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.