共用方式為


Remove-SCOMLocation

移除與位置的關聯,或刪除位置。

Syntax

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

Remove-SCOMLocation Cmdlet 會移除位置與代理程式管理的電腦、管理伺服器或資源集區的關聯,或刪除位置。 若要移除關聯,請指定代理程式管理的電腦、管理伺服器或資源集區。 若要刪除位置,請使用 Get-SCOMLocation Cmdlet 來指定位置。

您可以使用 Update-SCOMLocation Cmdlet 來變更位置顯示名稱、緯度或經度。

根據預設,此 Cmdlet 會使用與管理群組的作用中持續性連線。 使用 SCSession 參數來指定不同的持續性連線。 您可以使用 ComputerNameCredential 參數,建立與管理群組的暫時連線。 如需詳細資訊,請鍵入 Get-Help about_OpsMgr_Connections

範例

範例 1:刪除位置

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

本範例會刪除顯示名稱為 Seattle,WA 的位置。 第一個命令會取得具有顯示名稱 Seattle、WA 的位置物件,然後將物件儲存在$Location變數中。

第二個命令會刪除儲存在 $Location 變數中的位置物件。

範例 2:從位置移除代理程式管理的電腦

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

此範例會從其位置移除名為 Server73.Contoso.com 的代理程式管理電腦。 第一個命令會取得名為 Server73.Contoso.com 電腦的代理程式物件,然後將物件儲存在$Agent變數中。

第二個命令會從儲存在 $Agent 變數中的代理程式管理電腦物件中移除位置關聯。 此命令不會刪除位置本身。

範例 3:從位置移除管理伺服器

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

此範例會從其位置移除管理伺服器。 第一個命令會取得名為 MgmtServer01.Contoso.com 的管理伺服器物件,然後將物件儲存在$MgmtServer變數中。

第二個命令會從儲存在 $MgmtServer 變數中的管理伺服器物件中移除位置關聯。 此命令不會刪除位置本身。

範例 4:從位置移除資源集區

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

此範例會從其位置移除名為 Notifications 資源集區的資源集區。 第一個命令會取得名為 Notifications Resource Pool 的資源集區資源集區物件,然後將物件儲存在$Pool變數中。

第二個命令會從儲存在 $Pool 變數的資源集區物件中移除位置關聯。 此命令不會刪除位置本身。

參數

-Agent

指定 AgentManagedComputer 物件的陣列。 若要取得 AgentManagedComputer 物件,請使用 Get-SCOMAgent Cmdlet。

Type:AgentManagedComputer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

指定電腦名稱的陣列。 Cmdlet 會為這些電腦建立與管理群組的暫時連線。 您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱, (FQDN) 。 若要指定本機電腦,請輸入電腦名稱、localhost 或句點 (.)。

System Center 資料存取服務必須在電腦上執行。 如果您未指定電腦,Cmdlet 會使用電腦進行目前的管理群組連線。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

在執行 Cmdlet 前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定管理群組連線的 PSCredential 物件。 若要取得 PSCredential 物件,請使用 Get-Credential Cmdlet。 如需詳細資訊,請鍵入 Get-Help Get-Credential

如果您在 ComputerName 參數中指定電腦,請使用可存取該電腦的帳戶。 預設為目前使用者。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

將位置陣列指定為 EnterpriseManagementObject 物件。 若要取得位置,請使用 Get-SCOMLocation Cmdlet。

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementServer

指定管理伺服器物件的陣列。 若要取得管理伺服器物件,請使用 Get-SCOMManagementServer Cmdlet。

Type:ManagementServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pool

指定資源集區物件的陣列。 若要取得資源集區物件,請使用 Get-SCOMResourcePool Cmdlet。

Type:ManagementServicePool[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

指定 Connection 物件的陣列。 若要取得 Connection 物件,請使用 Get-SCOMManagementGroupConnection Cmdlet。

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False