New-SCADConnector
创建新的 Service Manager Active Directory 连接器。
语法
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 cmdlet 创建 Service Manager Active Directory 连接器。
仅当应用了 Service Manager 2012 R2 更新汇总 6 或更高版本时，以下参数才可用。
- 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 cmdlet 获取工作流帐户的运行方式帐户。 该命令将结果存储在$RunAsAccount变量中。
第二个命令使用 Get-Credential cmdlet 提示输入凭据，然后将凭据存储在$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 cmdlet 提示输入凭据，然后将凭据存储在$Credential变量中。
最后一个命令创建到本地域的 Active Directory 连接器，该连接器仅检索以字母 E 开头的用户帐户。
参数
-ADCredential
指定此 cmdlet 连接到域控制器时要使用的凭据。
| 类型: | System.Management.Automation.PSCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-ComputerFilter
指定一个筛选器，该筛选器选择连接器同步的计算机。
筛选器必须指定为 Active Directory 筛选器。
例如，以下筛选器包括同步中以 win 开头的所有计算机：
(name=win*)
| 类型: | System.String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ComputerName
指定运行 System Center Data Access 服务的计算机的名称。 Credential 参数中指定的用户帐户必须具有对指定计算机的访问权限。
| 类型: | System.String[] |
| Position: | Named |
| 默认值: | Localhost |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | System.Management.Automation.SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Credential
指定此 cmdlet 用于连接到运行 System Center Data Access 服务的服务器的凭据。 指定的用户帐户必须有权访问该服务器。
| 类型: | System.Management.Automation.PSCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
指定连接器的说明。
| 类型: | System.String |
| Position: | 1 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisplayName
指定连接器的显示名称属性。
| 类型: | System.String |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Enable
指示此 cmdlet 是启用或禁用连接器。
| 类型: | System.Boolean |
| Position: | Named |
| 默认值: | True |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ExpandGroups
指定此 cmdlet 以递归方式包括由 UserFilter 参数指定的组的成员。
| 类型: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassThru
指示此 cmdlet 返回它创建的 Active Directory 连接器。 可以将此对象传递给其他 cmdlet。
| 类型: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PrinterFilter
指定此 cmdlet 用于选择连接器同步的打印机的筛选器。
| 类型: | System.String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-QueryRoot
指定此 cmdlet 从中查询对象的 Active Directory 文件夹，例如 LDAP：//DC=scsm，DC=stbtest，DC=microsoft，DC=com。
| 类型: | System.String |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RunAsAccount
指定使用此连接器时要使用的 RunAs 帐户。
| 类型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
| Position: | 3 |
| 默认值: | Operational System Account |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ScheduleDay
指定连接器同步的星期几。 有效值为：
- 日常
- 星期日
- 星期一
- 星期二
- 星期三
- 星期四
- 星期五
- 星期六
| 类型: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
| 接受的值: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| 默认值: | Daily |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ScheduleHour
指定连接器开始同步的小时。 该值必须是从零（0）到 23 的数字。
| 类型: | System.Int32 |
| Position: | Named |
| 默认值: | 2 |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SCSession
指定一个对象，该对象表示与 Service Manager 管理服务器的会话。
| 类型: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SyncNow
使 Active Directory 连接器启动同步周期。
| 类型: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UserFilter
指定用于通过连接器同步选择用户所需的筛选器。
必须以 Active Directory 筛选器的形式指定值。
例如，此参数的以下值包括在 givenName 以 a开头的同步用户：
(givenname=a*)
| 类型: | System.String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
| 类型: | System.Management.Automation.SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None.
不能通过管道将输入传递给此 cmdlet。
输出
None.
此 cmdlet 不生成任何输出。