Udostępnij za pośrednictwem

Get-SCOMLocation

  • Odwołanie
Moduł:
OperationsManager

Pobiera lokalizacje.

Składnia

Get-SCOMLocation
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-Pool] <ManagementServicePool[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-SCOMLocation pobiera lokalizacje. Określ lokalizacje, które mają być uzyskiwane według nazwy wyświetlanej lub identyfikatora, lub przez określenie skojarzonych agentów, serwerów zarządzania lub pul zasobów.

Lokalizację można utworzyć przy użyciu polecenia cmdlet New-SCOMLocation.

Domyślnie to 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.

Przykłady

Przykład 1. Pobieranie lokalizacji według nazwy wyświetlanej

PS C:\>Get-SCOMLocation -DisplayName "Seattle, WA"

To polecenie pobiera lokalizację o nazwie wyświetlanej Seattle, WA.

Przykład 2. Pobieranie lokalizacji komputera zarządzanego przez agenta

PS C:\>$Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Get-SCOMLocation -Agent $Agent

W tym przykładzie jest pobierana lokalizacja komputera zarządzanego przez agenta. Pierwsze polecenie pobiera obiekt agenta dla komputera zarządzanego przez agenta o nazwie Server01.Contoso.com, a następnie przechowuje obiekt w zmiennej $Agent.

Drugie polecenie pobiera lokalizację obiektu agenta przechowywanego w zmiennej $Agent.

Przykład 3. Pobieranie lokalizacji serwera zarządzania

PS C:\>$MgmtSvr = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMLocation -ManagementServer $MgmtSvr

Ten przykład pobiera lokalizację serwera zarządzania o nazwie MgmtServer01.Contoso.com. Pierwsze polecenie pobiera obiekt serwera zarządzania dla serwera zarządzania o nazwie MgmtServer01.Contoso.com, a następnie przechowuje obiekt w zmiennej $MgmtSvr.

Drugie polecenie pobiera lokalizację obiektu serwera zarządzania przechowywanego w zmiennej $MgmtSvr.

Przykład 4. Pobieranie lokalizacji puli zasobów

PS C:\>$Pool = Get-SCOMResourcePool -Name "Pool01"
PS C:\> Get-SCOMLocation -Pool $Pool

W tym przykładzie jest pobierana lokalizacja puli zasobów o nazwie Pool01. Pierwsze polecenie pobiera obiekt puli zasobów dla puli zasobów o nazwie Pool01 i przechowuje obiekt w zmiennej $Pool.

Drugie polecenie pobiera lokalizację puli przechowywanej w zmiennej $Pool.

Parametry

-Agent

Określa tablicę obiektów AgentManagedComputer. Aby uzyskać obiekt AgentManagedComputer, użyj polecenia cmdlet Get-SCOMAgent.

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

-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ę (.).

Na komputerze musi być uruchomiona usługa System Center Data Access. 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 obiekt PSCredential dla połączenia grupy zarządzania. Aby uzyskać obiekt PSCredential, użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, 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

-DisplayName

Określa tablicę nazw wyświetlanych. Wartości dla tego parametru zależą od zlokalizowanych pakietów administracyjnych importowanych i ustawień regionalnych użytkownika z uruchomionym programem Windows PowerShell.

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

-Id

Określa tablicę unikatowych identyfikatorów lokalizacji.

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

-ManagementServer

Określa tablicę obiektów serwera zarządzania. Aby uzyskać obiekt serwera zarządzania, użyj polecenia cmdlet Get-SCOMManagementServer.

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

-Pool

Określa tablicę obiektów puli zasobów. Aby uzyskać obiekt puli zasobów, użyj polecenia cmdlet Get-SCOMResourcePool.

Typ:ManagementServicePool[]
Position:1
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ć obiekt Connection, użyj polecenia cmdlet Get-SCOMManagementGroupConnection.

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