Udostępnij przez


Set-SCOMLocation

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

Składnia

FromAgent (Domyślna)

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

FromManagementServer

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

FromPool

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.

Właściwości parametru

Typ:

AgentManagedComputer[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAgent
Position:1
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Location

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

Właściwości parametru

Typ:EnterpriseManagementObject
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ManagementServer

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

Właściwości parametru

Typ:

ManagementServer[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromManagementServer
Position:1
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Pool

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

Właściwości parametru

Typ:

ManagementServicePool[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromPool
Position:1
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SCSession

Określa tablicę obiektów połączenia . Aby uzyskać obiekt Connection, użyj polecenia cmdlet Get-SCOMManagementGroupConnection.

Właściwości parametru

Typ:

Connection[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.