Udostępnij za pośrednictwem

Set-SCOMLocation

  • Odwołanie
Moduł:
OperationsManager

Kojarzy komputery zarządzane przez agenta, serwery zarządzania lub pule zasobów z lokalizacją.

Składnia

Set-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMLocation
   [-Pool] <ManagementServicePool[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-SCOMLocation kojarzy co najmniej jeden komputer zarządzany przez agenta, serwery zarządzania lub pule zasobów z lokalizacją. To polecenie cmdlet usuwa bieżące skojarzenie, jeśli istnieje. Pulpit nawigacyjny mapy podsumowania monitorowania dostępności aplikacji internetowej zawiera informacje o stanie agentów, serwerów zarządzania i pul zasobów skojarzonych z lokalizacją.

Skojarzenie można usunąć przy użyciu polecenia cmdlet Remove-SCOMLocation. 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. Kojarzenie agenta z lokalizacją

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> $Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -Agent $Agent

Ten przykład kojarzy komputer zarządzany przez agenta o nazwie Sever01.Contoso.com z lokalizacją Seattle, WA. Pierwsze polecenie pobiera obiekt lokalizacji, który ma nazwę wyświetlaną Seattle, WA, a następnie przechowuje obiekt w zmiennej $Location.

Drugie polecenie pobiera obiekt agenta o nazwie Server01.Contoso.com, a następnie przechowuje obiekt w zmiennej $Agent.

Trzecie polecenie kojarzy lokalizację przechowywaną w zmiennej $Location z komputerem zarządzanym przez agenta przechowywanym w zmiennej $Agent. Jeśli wcześniej skojarzyliśmy ten komputer zarządzany przez agenta z lokalizacją, polecenie usunie to skojarzenie.

Przykład 2. Kojarzenie serwera zarządzania z lokalizacją

PS C:\>$Location = Get-SCOMLocation -DisplayName "New York, NY"
PS C:\> $MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -ManagementServer $MgmtServer

W tym przykładzie jest skojarzony serwer zarządzania o nazwie MgmtServer01.Contoso.com z lokalizacją Nowy Jork, NY. Pierwsze polecenie pobiera obiekt lokalizacji, który ma nazwę wyświetlaną Nowego Jorku, NY, a następnie przechowuje obiekt w zmiennej $Location.

Drugie polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com i przechowuje obiekt w zmiennej $MgmtServer.

Trzecie polecenie kojarzy lokalizację przechowywaną w zmiennej $Location z serwerem zarządzania przechowywanym w zmiennej $MgmtServer. Jeśli wcześniej skojarzyliśmy ten serwer zarządzania z lokalizacją, polecenie usunie to skojarzenie.

Przykład 3. Kojarzenie puli zasobów z lokalizacją

PS C:\>$Location = Get-SCOMLocation -DisplayName "Paris, FR"
PS C:\> $Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Set-SCOMLocation -Location $Location -Pool $Pool

Ten przykład kojarzy pulę zasobów o nazwie Notifications Resource Pool z lokalizacją Paris, FR. Pierwsze polecenie pobiera obiekt lokalizacji o nazwie wyświetlanej Paris, FR, a następnie przechowuje obiekt w zmiennej $Location.

Drugie polecenie pobiera pulę zasobów o nazwie Notifications Resource Pool, a następnie przechowuje obiekt w zmiennej $Pool.

Trzecie polecenie kojarzy lokalizację przechowywaną w zmiennej $Location z pulą zasobów przechowywaną w zmiennej $Pool. Jeśli wcześniej skojarzyliśmy pulę zasobów z lokalizacją, polecenie usunie to skojarzenie.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
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

-Location

Określa lokalizację jako obiekt EnterpriseManagementObject. Aby uzyskać lokalizację, użyj polecenia cmdlet Get-SCOMLocation.

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

-PassThru

Wskazuje, że polecenie cmdlet tworzy lub modyfikuje obiekt, którego polecenie może użyć w potoku. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False