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 , используйте командлет Get-SCOMManagementGroupConnection.

Свойства параметра

Тип:

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.