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
Вы можете изменить отображаемое имя расположения, широту или долготу с помощью командлет а 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[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromAgent
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ComputerName
Задает массив имен компьютеров. Командлет устанавливает временные подключения с группами управления для этих компьютеров. Вы можете использовать имена NetBIOS, IP-адреса или полные доменные имена (FQDN). Чтобы указать локальный компьютер, введите имя компьютера, localhost или точку (.).
Служба доступа к данным System Center должна работать на компьютере. Если компьютер не указан, командлет использует компьютер для текущего подключения группы управления.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает объект PSCredential для подключения группы управления.
Чтобы получить объект PSCredential, используйте командлет Get-Credential.
Дополнительные сведения см. в Get-Help Get-Credential.
Если указать компьютер в параметре ComputerName, используйте учетную запись, доступ к которому имеется. По умолчанию используется текущий пользователь.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Location
Задает массив расположений как объектов EnterpriseManagementObject. Чтобы получить расположение, используйте командлет Get-SCOMLocation.
Свойства параметра
| Тип: | EnterpriseManagementObject[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromLocation
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ManagementServer
Задает массив объектов сервера управления.
Чтобы получить объект сервера управления, используйте командлет get-SCOMManagementServer
Свойства параметра
| Тип: | ManagementServer[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromManagementServer
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Pool
Задает массив объектов пула ресурсов. Чтобы получить объект пула ресурсов, используйте командлет Get-SCOMResourcePool.
Свойства параметра
| Тип: | ManagementServicePool[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromPool
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SCSession
Задает массив объектов подключения
Свойства параметра
| Тип: | Connection[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.