Sdílet prostřednictvím

Remove-SCOMLocation

  • Reference
Modul:
OperationsManager

Odebere přidružení k umístění nebo odstraní umístění.

Syntaxe

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>]

Description

Rutina Remove-SCOMLocation odebere přidružení umístění k počítači spravovanému agentem, serveru pro správu nebo fondu zdrojů nebo odstraní umístění. Přidružení odeberete tak, že zadáte počítače spravované agentem, servery pro správu nebo fondy zdrojů. Pokud chcete odstranit umístění, zadejte umístění pomocí rutiny Get-SCOMLocation.

Zobrazovaný název umístění, zeměpisnou šířku nebo délku můžete změnit pomocí rutiny Update-SCOMLocation.

Ve výchozím nastavení tato rutina používá aktivní trvalé připojení ke skupině pro správu. Pomocí parametru SCSession zadejte jiné trvalé připojení. Dočasné připojení ke skupině pro správu můžete vytvořit pomocí parametrů ComputerName a přihlašovacích údajů. Další informace potřebujete zadáním Get-Help about_OpsMgr_Connections.

Příklady

Příklad 1: Odstranění umístění

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location

Tento příklad odstraní umístění, které má zobrazovaný název Seattle, WA. První příkaz získá objekt umístění, který má zobrazovaný název Seattle, WA a pak uloží objekt do proměnné $Location.

Druhý příkaz odstraní objekt umístění uložený v proměnné $Location.

Příklad 2: Odebrání počítače spravovaného agentem z umístění

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

Tento příklad odebere počítač spravovaný agentem s názvem Server73.Contoso.com z jeho umístění. První příkaz získá objekt agenta pro počítač s názvem Server73.Contoso.com a pak uloží objekt do $Agent proměnné.

Druhý příkaz odebere přidružení umístění z objektu počítače spravovaného agentem uloženým v proměnné $Agent. Tento příkaz neodstraní samotné umístění.

Příklad 3: Odebrání serveru pro správu z umístění

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

Tento příklad odebere server pro správu z jeho umístění. První příkaz získá objekt serveru pro správu s názvem MgmtServer01.Contoso.com a pak uloží objekt do proměnné $MgmtServer.

Druhý příkaz odebere přidružení umístění z objektu serveru pro správu uloženého v proměnné $MgmtServer. Tento příkaz neodstraní samotné umístění.

Příklad 4: Odebrání fondu zdrojů z umístění

PS C:\>$Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Remove-SCOMLocation -Pool $Pool

Tento příklad odebere fond zdrojů s názvem Fond zdrojů oznámení z jeho umístění. První příkaz získá objekt fondu zdrojů pro fond zdrojů s názvem Notification Resource Pool a pak uloží objekt do $Pool proměnné.

Druhý příkaz odebere přidružení umístění z objektu fondu zdrojů uloženého v proměnné $Pool. Tento příkaz neodstraní samotné umístění.

Parametry

-Agent

Určuje pole AgentManagedComputer objekty. K získání objektu AgentManagedComputer použijte rutinu Get-SCOMAgent.

Typ:AgentManagedComputer[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje pole názvů počítačů. Rutina vytvoří dočasná připojení ke skupinám pro správu pro tyto počítače. Můžete použít názvy NetBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).

Na počítači musí být spuštěná služba System Center Data Access. Pokud nezadáte počítač, rutina použije počítač pro aktuální připojení skupiny pro správu.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje objekt PSCredential pro připojení skupiny pro správu. K získání objektu PSCredential použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credential.

Pokud zadáte počítač v parametru ComputerName, použijte účet, který má přístup k danému počítači. Výchozí hodnota je aktuální uživatel.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Location

Určuje pole umístění jako EnterpriseManagementObject objekty. K získání umístění použijte rutinu Get-SCOMLocation.

Typ:EnterpriseManagementObject[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ManagementServer

Určuje pole objektů serveru pro správu. K získání objektu serveru pro správu použijte rutinu Get-SCOMManagementServer.

Typ:ManagementServer[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Pool

Určuje pole objektů fondu zdrojů. K získání objektu fondu zdrojů použijte rutinu Get-SCOMResourcePool.

Typ:ManagementServicePool[]
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SCSession

Určuje pole objektů Connection. K získání objektu připojení použijte rutinu Get-SCOMManagementGroupConnection.

Typ:Connection[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False