Remove-SCOMLocation

删除与位置的关联或删除位置。

语法

FromAgent (默认值)

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

说明

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 的位置对象,然后将该对象存储在 $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 Resource Pool 的资源池的资源池对象,然后将该对象存储在 $Pool 变量中。

第二个命令从存储在 $Pool 变量中的资源池对象中删除位置关联。 此命令不会删除位置本身。

参数

-Agent

指定 AgentManagedComputer 对象的数组。 若要获取 AgentManagedComputer 对象,请使用 Get-SCOMAgent cmdlet。

参数属性

类型:

AgentManagedComputer[]

默认值:None
支持通配符:False
不显示:False

参数集

FromAgent
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ComputerName

指定一个包含计算机名称的数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 您可以使用 NetBIOS 名称、IP 地址或完全限定域名 (FQDN)。 若要指定本地计算机,请键入计算机名称、localhost 或点(.)。

System Center 数据访问服务必须在计算机上运行。 如果未指定计算机,则 cmdlet 将使用该计算机进行当前管理组连接。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Credential

为管理组连接指定 PSCredential 对象。 若要获取 PSCredential 对象,请使用 Get-Credential cmdlet。 要了解详情,请键入 Get-Help Get-Credential

如果在 ComputerName 参数中指定计算机,请使用有权访问该计算机的帐户。 默认值为当前用户。

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Location

将位置数组指定为 EnterpriseManagementObject 对象。 若要获取位置,请使用 Get-SCOMLocation cmdlet。

参数属性

类型:

EnterpriseManagementObject[]

默认值:None
支持通配符:False
不显示:False

参数集

FromLocation
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ManagementServer

指定管理服务器对象数组。 若要获取管理服务器对象,请使用 Get-SCOMManagementServer cmdlet。

参数属性

类型:

ManagementServer[]

默认值:None
支持通配符:False
不显示:False

参数集

FromManagementServer
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Pool

指定资源池对象的数组。 若要获取资源池对象,请使用 Get-SCOMResourcePool cmdlet。

参数属性

类型:

ManagementServicePool[]

默认值:None
支持通配符:False
不显示:False

参数集

FromPool
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SCSession

指定 Connection 对象的数组。 若要获取 Connection 对象,请使用 Get-SCOMManagementGroupConnection cmdlet。

参数属性

类型:

Connection[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters