Add-SCOMADAgentAssignment
Назначает управляемые агентом AD DS компьютеры группе управления.
Синтаксис
Default (по умолчанию)
Add-SCOMADAgentAssignment
[-Domain] <String>
[-PrimaryServer] <ManagementServer>
[-LdapQuery] <String>
[-RunAsProfile <ManagementPackSecureReference>]
[-FailoverServer <ManagementServer[]>]
[-Exclude <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет add-SCOMADAgentAssignment назначает один или несколько управляемых агентом доменных служб Active Directory (AD DS) группе управления System Center — Operations Manager.
Прежде чем использовать этот командлет для назначения управляемых агентом компьютеров группе управления, используйте MOMADAdmin.exe для создания контейнера AD DS для группы управления Operations Manager в домене компьютеров.
Примеры
Пример 1. Назначение управляемых агентом AD DS компьютеров группе управления
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -Exclude "SQLServer05.fabrikam.net"
В этом примере компьютер, управляемый агентом AD DS, назначается группе управления.
Первая команда получает объект сервера управления с именем DivMgmtSvr01.fabrikam.net и сохраняет объект в переменной $PrimaryServer.
Вторая команда задает запрос LDAP, который выбирает компьютеры с именами, такими как SQLServer*.fabrikam.net, и сохраняет объект в переменной $Ldap.
Третья команда назначает управляемые агентом AD DS компьютеры, хранящиеся в $Ldap группе управления в домене fabrikam.net. Команда исключает компьютер с именем SQLServer05.fabrikam.net из группы управления.
Пример 2. Задание отработки отказа для назначения агента AD DS
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Failovers = Get-SCOMManagementServer -Name "FabrikamSecondary*.fabrikam.net"
PS C:\> $RunAs = Get-SCOMRunAsProfile -Name "Active Directory Based Agent Assignment Account"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -FailoverServer $Failovers -RunAsProfile $RunAs
В этом примере компьютер, управляемый агентом AD DS, назначается группе управления и задает отработку отказа для агента.
Первая команда получает объект сервера управления с именем DivMgmtSvr01.fabrikam.net и сохраняет объект в переменной $PrimaryServer.
Вторая команда получает серверы управления с именем, например FabrikamSecondary*.fabrikam.net, и сохраняет объекты в переменной $Failovers.
Третья команда возвращает объект профиля "Учетная запись назначения агента на основе Active Directory" и сохраняет объект в переменной $RunAs.
Четвертая команда указывает запрос LDAP, который выбирает компьютеры с именами, такими как SQLServer*.fabrikam.net, и сохраняет результат в переменной $Ldap.
Пятая команда назначает управляемые агентом AD DS компьютеры, хранящиеся в $Ldap группе управления в домене fabrikam.net. Команда указывает основной сервер управления, хранящийся в $PrimaryServer для управляемых агентом компьютеров. Команда указывает серверы управления, хранящиеся в $Failovers, как отработка отказа для управляемых агентом компьютеров. Команда указывает профиль запуска от имени, хранящийся в $RunAs для управляемых агентом компьютеров.
Параметры
-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 |
-Domain
Указывает имя домена или контроллера домена, в котором находятся целевые агенты.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Постоянный ток (DC) |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Exclude
Задает массив имен компьютеров. Operations Manager исключает компьютеры, указанные из назначения агента.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FailoverServer
Задает массив имен объектов ManagementServer. Этот параметр указывает серверы управления, которые Operations Manager использует в качестве отработки отказа для целевых агентов.
По умолчанию Operations Manager использует все серверы управления, отличные от шлюза, для отработки отказа.
Свойства параметра
| Тип: | ManagementServer[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LdapQuery
Указывает запрос LDAP в домене, который выбирает целевые компьютеры агента.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 3 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PrimaryServer
Указывает объект ManagementServer. Этот параметр задает основной сервер управления для целевого компьютера, управляемого агентом. Чтобы получить объект ManagementServer, используйте командлет Get-SCOMManagementServer.
Свойства параметра
| Тип: | ManagementServer |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RunAsProfile
Указывает профиль запуска от имени, используемый Operations Manager для выполнения рабочего процесса запроса AD DS.
Профиль запуска от имени должен быть связан с той же учетной записью запуска, которую вы указываете при запуске MOMADAdmin.exe для создания контейнера AD DS для группы управления System Center — Operations Manager.
Свойства параметра
| Тип: | ManagementPackSecureReference |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | 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.