New-SCADConnector
Создает новый соединитель Active Directory Service Manager.
Синтаксис
New-SCADConnector
[[-Description] <String>]
[-Enable <Boolean>]
[-DisplayName] <String>
[[-QueryRoot] <String>]
[-PassThru]
[-ComputerFilter <String>]
[-UserFilter <String>]
[-PrinterFilter <String>]
-ADCredential <PSCredential>
[[-RunAsAccount] <ManagementPackSecureReference>]
[-ScheduleDay <DaySchedule>]
[-ScheduleHour <Int32>]
[-SyncNow]
[-ExpandGroups]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-SCADConnector создает соединитель Active Directory Service Manager.
Следующие параметры доступны только в том случае, если вы применили накопительный пакет обновления 6 или более поздние версии Service Manager 2012 R2.
- ScheduleDay
- ScheduleHour
Примеры
Пример 1. Создание соединителя в локальном домене
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso AD Connector" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -ScheduleDay Sunday -ScheduleHour 3
Первая команда получает учетную запись запуска от имени для учетной записи рабочего процесса с помощью командлета Get-SCSMRunAsAccount. Команда сохраняет результат в переменной $RunAsAccount.
Вторая командная строка запрашивает учетные данные с помощью командлета Get-Credential, а затем сохраняет учетные данные в переменной $Credential.
Последняя команда создает соединитель Active Directory в локальный домен, который извлекает все компьютеры, принтеры, пользователи и группы пользователей. Соединитель настроен для синхронизации каждую воскресенье в 3:00 утра.
Пример 2. Создание соединителя в локальном домене, включающее фильтр пользователя
PS C:\>$RunAsAccount = Get-SCSMRunAsAccount -DisplayName "Workflow Account"
PS C:\> $Credential = Get-Credential
PS C:\> New-SCADConnector -DisplayName "Contoso AD Connector" -Description "Contoso users starting with E" -QueryRoot "LDAP://DC=Contoso,DC=com" -RunAsAccount $RunAsAccount -ADCredential $Credential -Enable $False -UserFilter "(givenname=E*)"
Первая команда получает учетную запись запуска от имени для учетной записи рабочего процесса, а затем сохраняет ее в переменной $RunAsAccount.
Вторая командная строка запрашивает учетные данные с помощью командлета Get-Credential, а затем сохраняет учетные данные в переменной $Credential.
Последняя команда создает соединитель Active Directory в локальный домен, который извлекает только учетные записи пользователей, начинающиеся с буквы E.
Параметры
-ADCredential
Указывает учетные данные, используемые при подключении этого командлета к контроллеру домена.
Тип: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ComputerFilter
Указывает фильтр, который выбирает компьютеры, синхронизируемые соединителем.
Фильтр должен быть указан в качестве фильтра Active Directory.
Например, следующий фильтр включает все компьютеры, начинающиеся с win
в синхронизации:
(name=win*)
Тип: | System.String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ComputerName
Указывает имя компьютера, на котором выполняется служба доступа к данным System Center.
Учетная запись пользователя, указанная в параметре учетных данных
Тип: | System.String[] |
Position: | Named |
Default value: | Localhost |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Credential
Указывает учетные данные, которые этот командлет использует для подключения к серверу, на котором выполняется служба доступа к данным System Center. Указанная учетная запись пользователя должна иметь права доступа к серверу.
Тип: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Description
Указывает описание соединителя.
Тип: | System.String |
Position: | 1 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisplayName
Указывает свойство отображаемого имени соединителя.
Тип: | System.String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Enable
Указывает, включает ли этот командлет или отключает соединитель.
Тип: | System.Boolean |
Position: | Named |
Default value: | True |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ExpandGroups
Указывает, что этот командлет рекурсивно включает члены групп, указанных параметром UserFilter.
Тип: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PassThru
Указывает, что этот командлет возвращает создаваемый соединитель Active Directory. Этот объект можно передать другим командлетам.
Тип: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PrinterFilter
Указывает фильтр, используемый этим командлетом для выбора принтеров, синхронизированных соединителем.
Тип: | System.String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-QueryRoot
Указывает папку Active Directory, из которой этот командлет запрашивает объекты, такие как LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.
Тип: | System.String |
Position: | 2 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RunAsAccount
Указывает учетную запись запуска, используемую при использовании этого соединителя.
Тип: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
Position: | 3 |
Default value: | Operational System Account |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ScheduleDay
Указывает день недели, в течение которой соединитель синхронизируется. Допустимые значения:
- Ежедневный
- Воскресенье
- Понедельник
- Вторник
- Среда
- Четверг
- Пятница
- Суббота
Тип: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
Допустимые значения: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
Position: | Named |
Default value: | Daily |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ScheduleHour
Указывает час, с которого соединитель запускает синхронизацию. Значение должно быть числом от нуля (0) до 23.
Тип: | System.Int32 |
Position: | Named |
Default value: | 2 |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SCSession
Указывает объект, представляющий сеанс на сервере управления Service Manager.
Тип: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SyncNow
Вызывает запуск цикла синхронизации соединителя Active Directory.
Тип: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UserFilter
Указывает фильтр, используемый для выбора пользователей, синхронизированный соединителем.
Необходимо указать значение в виде фильтра Active Directory.
Например, следующее значение для этого параметра включается в пользователей синхронизации, заданного имени начинается с a
:
(givenname=a*)
Тип: | System.String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None.
Входные данные в этот командлет невозможно передать.
Выходные данные
None.
Этот командлет не создает выходные данные.