Udostępnij za pośrednictwem

Get-SCXAgent

  • Odwołanie
Moduł:
OperationsManager

Pobiera listę zarządzanych komputerów z systemami UNIX i Linux w grupie zarządzania.

Składnia

Get-SCXAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ID <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ResourcePool <ManagementServicePool>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-SCXAgent pobiera zarządzane komputery z systemami UNIX i Linux zgodne z podanymi kryteriami wyboru. Jeśli nie określono kryteriów wyboru, zwracane są wszystkie zarządzane komputery z systemami UNIX i Linux w grupie zarządzania.

Wyniki są zwracane jako tablica zarządzanych obiektów komputerów z systemami UNIX i Linux.

Przykłady

Przykład 1. Zwracanie zarządzanych komputerów z systemami UNIX i Linux

PS C:\>Get-SCXAgent

To polecenie zwraca wszystkie zarządzane komputery z systemami UNIX i Linux w puli zasobów.

Przykład 2. Zwracanie zarządzanych komputerów z systemami UNIX i Linux z puli zasobów

PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePool

Pierwsze polecenie pobiera pulę zasobów przy użyciu polecenia cmdlet Get-SCOMResourcePool i zapisuje je w zmiennej $ResourcePool.

Drugie polecenie zwraca wszystkie zarządzane komputery z systemami UNIX i Linux dla puli zasobów w $ResourcePool.

Przykład 3. Zwracanie zarządzanych komputerów z systemami UNIX i Linux przy użyciu nazwy

PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"

To polecenie zwraca zarządzane komputery z systemami UNIX i Linux o nazwach pasujących do podanej listy ciągów.

Przykład 4. Zwracanie zarządzanych komputerów z systemami UNIX i Linux przy użyciu potoku

PS C:\>"server1", "server2", "server3" | Get-SCXAgent

To polecenie udostępnia parametr Name za pośrednictwem potoku.

Przykład 5. Nawiązywanie połączenia z pulą zasobów i uzyskiwanie zarządzanego komputera według nazwy

PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"

To polecenie łączy się z pulą zasobów z tymczasowym połączeniem przy użyciu poświadczeń bieżącego użytkownika i zwraca tylko zarządzane komputery zgodne z właściwością Name .

Parametry

-ComputerName

Określa tablicę nazw komputerów. Polecenie cmdlet ustanawia tymczasowe połączenia z grupami zarządzania dla tych komputerów. Możesz 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 nie określisz komputera, polecenie cmdlet używa komputera do 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

-ID

Określa identyfikator zarządzanego obiektu komputera z systemem UNIX lub Linux. Zwraca tylko zarządzane komputery z właściwościami identyfikatora, które pasują do tej wartości. Ten parametr jest akceptowany z potoku.

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

-Name

Określa listę w pełni kwalifikowanych nazw domen dla co najmniej jednego zarządzanego komputera z systemami UNIX i Linux. Zwraca tylko zarządzane komputery zgodne z właściwością Name .

Można uwzględnić symbole wieloznaczne, w tym przypadku zwracane są wszystkie komputery pasujące do symboli wieloznacznych. Aby uzyskać informacje o korzystaniu z symboli wieloznacznych, wpisz Get-Help About_Wildcards.

Ten parametr jest akceptowany z potoku.

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

-ResourcePool

Określa pulę zasobów serwerów, która ma być bieżącym serwerem zarządzania, a druga 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 na temat pobierania obiektu SCOMResourcePool , wpisz Get-Help Get-SCOMResourcePool.

Type:ManagementServicePool
Aliases:RP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

Dane wyjściowe

Microsoft.Unix.Computer[]

To polecenie cmdlet zwraca co najmniej jeden obiekt komputerów reprezentujących zarządzane komputery z systemami UNIX i Linux, gdy komputery z systemami UNIX i Linux spełniają kryteria wejściowe.