Remove-SCOMLocation
删除与某个位置的关联或删除位置。
语法
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>]
说明
Remove-SCOMLocation cmdlet 删除与代理管理的计算机、管理服务器或资源池的位置关联,或者删除位置。 若要删除关联,请指定代理管理的计算机、管理服务器或资源池。 若要删除某个位置,请使用 Get-SCOMLocation cmdlet 指定位置。
可以使用 Update-SCOMLocation cmdlet 更改位置显示名称、纬度或经度。
默认情况下,此 cmdlet 使用与管理组的活动持久连接。
使用 SCSession 参数指定不同的持久连接。
可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。
要了解详情,请键入 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 Data Access 服务必须在计算机上运行。 如果未指定计算机,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 |