Remove-SCOMLocation
Usuwa skojarzenia z lokalizacją lub usuwa lokalizację.
Składnia
FromAgent (Domyślna)
Remove-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromManagementServer
Remove-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromPool
Remove-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromLocation
Remove-SCOMLocation
[-Location] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-SCOMLocation usuwa skojarzenie lokalizacji z komputerem zarządzanym przez agenta, serwerem zarządzania lub pulą zasobów albo usuwa lokalizację. Aby usunąć skojarzenie, określ komputery zarządzane przez agenta, serwery zarządzania lub pule zasobów. Aby usunąć lokalizację, określ lokalizację przy użyciu polecenia cmdlet Get-SCOMLocation.
Nazwę wyświetlaną lokalizacji, szerokość geograficzną lub długość geograficzną można zmienić przy użyciu polecenia cmdlet Update-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 Get-Help about_OpsMgr_Connections.
Przykłady
Przykład 1. Usuwanie lokalizacji
PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location
W tym przykładzie usunięto lokalizację o nazwie wyświetlanej Seattle, WA. Pierwsze polecenie pobiera obiekt lokalizacji o nazwie wyświetlanej Seattle, WA, a następnie przechowuje obiekt w zmiennej $Location.
Drugie polecenie usuwa obiekt lokalizacji przechowywany w zmiennej $Location.
Przykład 2. Usuwanie komputera zarządzanego przez agenta z lokalizacji
PS C:\>$Agent = Get-SCOMAgent -Name "Server73.Contoso.com"
PS C:\> Remove-SCOMLocation -Agent $Agent
Ten przykład usuwa komputer zarządzany przez agenta o nazwie Server73.Contoso.com z jego lokalizacji. Pierwsze polecenie pobiera obiekt agenta dla komputera o nazwie Server73.Contoso.com, a następnie zapisuje obiekt w zmiennej $Agent.
Drugie polecenie usuwa skojarzenie lokalizacji z obiektu komputera zarządzanego przez agenta przechowywanego w zmiennej $Agent. To polecenie nie powoduje usunięcia samej lokalizacji.
Przykład 3. Usuwanie serwera zarządzania z lokalizacji
PS C:\>$MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Remove-SCOMLocation -ManagementServer $MgmtServer
W tym przykładzie serwer zarządzania jest usuwany z jego lokalizacji. Pierwsze polecenie pobiera obiekt serwera zarządzania o nazwie MgmtServer01.Contoso.com, a następnie przechowuje obiekt w zmiennej $MgmtServer.
Drugie polecenie usuwa skojarzenie lokalizacji z obiektu serwera zarządzania przechowywanego w zmiennej $MgmtServer. To polecenie nie powoduje usunięcia samej lokalizacji.
Przykład 4. Usuwanie puli zasobów z lokalizacji
PS C:\>$Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Remove-SCOMLocation -Pool $Pool
W tym przykładzie usunięto pulę zasobów o nazwie Notifications Resource Pool z jego lokalizacji. Pierwsze polecenie pobiera obiekt puli zasobów dla puli zasobów o nazwie Notifications Resource Pool, a następnie przechowuje obiekt w zmiennej $Pool.
Drugie polecenie usuwa skojarzenie lokalizacji z obiektu puli zasobów przechowywanego w zmiennej $Pool. To polecenie nie powoduje usunięcia samej lokalizacji.
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 tablicę lokalizacji jako obiekty 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
FromLocation
| 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 |
-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 |
-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
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.