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 參數來指定不同的持續性連線。
您可以使用 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 資料存取服務必須在電腦上執行。 如果您未指定電腦,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 |