New-SCADConnector

Создает новый соединитель Active Directory Service Manager.

Синтаксис

Default (по умолчанию)

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.

  • РасписаниеДень
  • РасписаниеЧас

Примеры

Пример 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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ComputerFilter

Указывает фильтр, который выбирает компьютеры, синхронизируемые соединителем. Фильтр должен быть указан в качестве фильтра Active Directory. Например, следующий фильтр включает все компьютеры, начинающиеся с win в синхронизации:

(name=win*)

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

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ComputerName

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

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

Тип:

System.String[]

Default value:Localhost
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском командлета.

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

Тип:System.Management.Automation.SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Credential

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

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

Тип:System.Management.Automation.PSCredential
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

Указывает описание соединителя.

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

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisplayName

Указывает свойство отображаемого имени соединителя.

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

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Enable

Указывает, включает ли этот командлет или отключает соединитель.

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

Тип:System.Boolean
Default value:True
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExpandGroups

Указывает, что этот командлет рекурсивно включает члены групп, указанных параметром UserFilter.

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

Тип:System.Management.Automation.SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PassThru

Указывает, что этот командлет возвращает создаваемый соединитель Active Directory. Этот объект можно передать другим командлетам.

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

Тип:System.Management.Automation.SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PrinterFilter

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

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

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-QueryRoot

Указывает папку Active Directory, из которой этот командлет запрашивает объекты, такие как LDAP://DC=scsm,DC=stbtest,DC=microsoft,DC=com.

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

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsAccount

Указывает учетную запись запуска, используемую при использовании этого соединителя.

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

Тип:Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
Default value:Operational System Account
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:3
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ScheduleDay

Указывает день недели, в течение которой соединитель синхронизируется. Допустимые значения:

  • Ежедневный
  • Воскресенье
  • Понедельник
  • Вторник
  • Среда
  • Четверг
  • Пятница
  • Суббота

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

Тип:Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule
Default value:Daily
Допустимые значения:Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ScheduleHour

Указывает час, с которого соединитель запускает синхронизацию. Значение должно быть числом от нуля (0) до 23.

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

Тип:System.Int32
Default value:2
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SCSession

Указывает объект, представляющий сеанс на сервере управления Service Manager.

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

Тип:

Microsoft.SystemCenter.Core.Connection.Connection[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SyncNow

Вызывает запуск цикла синхронизации соединителя Active Directory.

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

Тип:System.Management.Automation.SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UserFilter

Указывает фильтр, используемый для выбора пользователей, синхронизированный соединителем. Необходимо указать значение в виде фильтра Active Directory. Например, следующее значение для этого параметра включается в пользователей синхронизации, заданного имени начинается с a:

(givenname=a*)

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

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

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

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

Тип:System.Management.Automation.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.

Входные данные

None.

Входные данные в этот командлет невозможно передать.

Выходные данные

None.

Этот командлет не создает выходные данные.