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
Вы можете изменить отображаемое имя расположения, широту или долготу с помощью командлет а Update-SCOMLocation.
По умолчанию этот командлет использует активное постоянное подключение к группе управления.
Используйте параметр SCSession для указания другого постоянного подключения.
Можно создать временное подключение к группе управления с помощью параметров ComputerName и учетных данных.
Дополнительные сведения см. в Get-Help about_OpsMgr_Connections
.
Примеры
Пример 1. Удаление расположения
PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location
В этом примере удаляется расположение, в котором отображается отображаемое имя Сиэтла, WA. Первая команда получает объект расположения, имеющий отображаемое имя Сиэтл, 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.
Тип: | AgentManagedComputer[] |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ComputerName
Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Служба доступа к данным System Center должна работать на компьютере. Если компьютер не указан, командлет использует компьютер для текущего подключения группы управления.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Credential
Указывает объект PSCredential для подключения группы управления.
Чтобы получить объект PSCredential, используйте командлет Get-Credential.
Дополнительные сведения см. в Get-Help Get-Credential
.
Если указать компьютер в параметре ComputerName, используйте учетную запись, доступ к которому имеется. По умолчанию используется текущий пользователь.
Тип: | PSCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Location
Задает массив расположений как объектов EnterpriseManagementObject. Чтобы получить расположение, используйте командлет Get-SCOMLocation.
Тип: | EnterpriseManagementObject[] |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ManagementServer
Задает массив объектов сервера управления.
Чтобы получить объект сервера управления, используйте командлет get-SCOMManagementServer
Тип: | ManagementServer[] |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Pool
Задает массив объектов пула ресурсов. Чтобы получить объект пула ресурсов, используйте командлет Get-SCOMResourcePool.
Тип: | ManagementServicePool[] |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-SCSession
Задает массив объектов подключения
Тип: | Connection[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |