Udostępnij za pośrednictwem

Remove-SCOMLocation

  • Odwołanie
Moduł:
OperationsManager

Usuwa skojarzenia z lokalizacją lub usuwa lokalizację.

Składnia

Remove-SCOMLocation
      [-Agent] <AgentManagedComputer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-ManagementServer] <ManagementServer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-Pool] <ManagementServicePool[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 ComputerName i Credential. Aby uzyskać więcej informacji, wpisz 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.

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 tablicę lokalizacji jako obiekty EnterpriseManagementObject. Aby uzyskać lokalizację, użyj polecenia cmdlet Get-SCOMLocation.

Typ:EnterpriseManagementObject[]
Position:1
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

-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