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 nazwa 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ą Nazwa.

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

-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 są zgodne z tą wartością. Ten parametr jest akceptowany z potoku.

Typ:Guid[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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ą nazwa .

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

Ten parametr jest akceptowany z potoku.

Typ:String[]
Aliasy:DisplayName
Position:1
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 drugi 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.

Typ:ManagementServicePool
Aliasy:RP
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
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

Dane wyjściowe

Microsoft.Unix.Computer[]

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