Set-SCOMLocation

Модуль:

OperationsManager

Связывает управляемые агентом компьютеры, серверы управления или пулы ресурсов с расположением.

Синтаксис

Set-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

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[]
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:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ManagementServer

Задает массив объектов сервера управления. Чтобы получить объект сервера управления, используйте командлет get-SCOMManagementServer .

Тип:	ManagementServer[]
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-PassThru

Указывает, что командлет создает или изменяет объект, который команда может использовать в конвейере. По умолчанию этот командлет не создает выходные данные.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Pool

Задает массив объектов пула ресурсов. Чтобы получить объект пула ресурсов, используйте командлет Get-SCOMResourcePool.

Тип:	ManagementServicePool[]
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SCSession

Задает массив объектов подключения . Чтобы получить объект connection , используйте командлет Get-SCOMManagementGroupConnection.

Тип:	Connection[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Связанные ссылки

• Get-SCOMAgent
• Get-SCOMManagementServer
• Get-SCOMResourcePool
• Get-SCOMLocation
• New-SCOMLocation
• Remove-SCOMLocation
• Update-SCOMLocation