Set-SCOMLocation
Связывает управляемые агентом компьютеры, серверы управления или пулы ресурсов с расположением.
Синтаксис
FromAgent (по умолчанию)
Set-SCOMLocation
[-Agent] <AgentManagedComputer[]>
-Location <EnterpriseManagementObject>
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromManagementServer
Set-SCOMLocation
[-ManagementServer] <ManagementServer[]>
-Location <EnterpriseManagementObject>
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromPool
Set-SCOMLocation
[-Pool] <ManagementServicePool[]>
-Location <EnterpriseManagementObject>
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет set-SCOMLocation
Связь можно удалить с помощью командлета Remove-SCOMLocation.
Вы можете создать расположение с помощью командлета New-SCOMLocation
По умолчанию этот командлет использует активное постоянное подключение к группе управления.
Используйте параметр SCSession для указания другого постоянного подключения.
Можно создать временное подключение к группе управления с помощью параметров ComputerName и учетных данных.
Дополнительные сведения см. в Get-Help about_OpsMgr_Connections.
Примеры
Пример 1. Связывание агента с расположением
PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> $Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -Agent $Agent
В этом примере связывается управляемый агентом компьютер с именем Sever01.Contoso.com с расположением Сиэтла, WA. Первая команда получает объект location, имеющий отображаемое имя Сиэтла, WA, а затем сохраняет объект в переменной $Location.
Вторая команда получает объект агента с именем Server01.Contoso.com, а затем сохраняет объект в переменной $Agent.
Третья команда связывает расположение, хранящееся в переменной $Location, с управляемым агентом компьютером, хранящимся в переменной $Agent. Если вы ранее связыли этот управляемый агентом компьютер с расположением, команда удаляет эту связь.
Пример 2. Связывание сервера управления с расположением
PS C:\>$Location = Get-SCOMLocation -DisplayName "New York, NY"
PS C:\> $MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -ManagementServer $MgmtServer
В этом примере связывается сервер управления с именем MgmtServer01.Contoso.com с расположением Нью-йорк, нью-йорк. Первая команда получает объект location, имеющий отображаемое имя Нью-йорка, нью-йорка, нью-йорка, а затем сохраняет объект в переменной $Location.
Вторая команда получает объект сервера управления с именем MgmtServer01.Contoso.com и сохраняет объект в переменной $MgmtServer.
Третья команда связывает расположение, хранящееся в переменной $Location, с сервером управления, хранящимся в переменной $MgmtServer. Если вы ранее связыли этот сервер управления с расположением, команда удаляет эту связь.
Пример 3. Связывание пула ресурсов с расположением
PS C:\>$Location = Get-SCOMLocation -DisplayName "Paris, FR"
PS C:\> $Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Set-SCOMLocation -Location $Location -Pool $Pool
В этом примере пул ресурсов с именем "Пул ресурсов уведомлений" связывается с расположением Paris, FR. Первая команда получает объект расположения, имеющий отображаемое имя Paris, FR, а затем сохраняет объект в переменной $Location.
Вторая команда получает пул ресурсов с именем "Пул ресурсов уведомлений", а затем сохраняет объект в переменной $Pool.
Третья команда связывает расположение, хранящееся в переменной $Location, с пулом ресурсов, хранящимся в переменной $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 |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ManagementServer
Задает массив объектов сервера управления.
Чтобы получить объект сервера управления, используйте командлет get-SCOMManagementServer
Свойства параметра
| Тип: | ManagementServer[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromManagementServer
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PassThru
Указывает, что командлет создает или изменяет объект, который команда может использовать в конвейере. По умолчанию этот командлет не создает выходные данные.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | 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.