New-SCADConnector
建立新的 Service Manager Active Directory 連接器。
Syntax
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>]Description
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 連線到網域控制站時要使用的認證。
| Type: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerFilter
指定篩選準則，以選取連接器同步處理的電腦。
篩選條件必須指定為 Active Directory 篩選器。
例如，下列篩選包含同步處理中開頭 win 的所有電腦：
(name=win*)
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
指定 System Center 資料存取服務執行所在的電腦名稱。 Credential參數中指定的使用者帳戶必須具有指定電腦的存取權限。
| Type: | System.String[] |
| Position: | Named |
| Default value: | Localhost |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | System.Management.Automation.SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定此 Cmdlet 用來連線到 System Center Data Access 服務執行所在伺服器的認證。 指定的使用者帳戶必須具有該伺服器的存取權限。
| Type: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定連接器的描述。
| Type: | System.String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
指定連接器的顯示名稱屬性。
| Type: | System.String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Enable
指出此 Cmdlet 是否啟用或停用連接器。
| Type: | System.Boolean |
| Position: | Named |
| Default value: | True |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExpandGroups
指定此 Cmdlet 會以遞迴方式包含 UserFilter 參數所指定群組的成員。
| Type: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
指出此 Cmdlet 會傳回它所建立的 Active Directory 連接器。 您可以將這個物件傳遞至其他 Cmdlet。
| Type: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrinterFilter
指定此 Cmdlet 用來選取連接器同步處理的印表機的篩選準則。
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QueryRoot
指定此 Cmdlet 查詢物件的 Active Directory 資料夾，例如 LDAP：//DC=scsm、DC=stbtest、DC=microsoft、DC=com。
| Type: | System.String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsAccount
指定在使用此連接器時要使用的 RunAs 帳戶。
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference |
| Position: | 3 |
| Default value: | Operational System Account |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleDay
指定連接器同步處理的星期數。 有效值為：
- 每日
- 星期日
- 星期一
- Tuesday
- 星期三
- Thursday
- 星期五
- 星期六
| Type: | Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule |
| Accepted values: | Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | Daily |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleHour
指定連接器開始同步處理的小時。 此值必須是從零 (0 到 23 的數位) 。
| Type: | System.Int32 |
| Position: | Named |
| Default value: | 2 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
指定代表 Service Manager 管理伺服器工作階段的物件。
| Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SyncNow
會導致 Active Directory 連接器啟動同步處理循環。
| Type: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserFilter
指定篩選條件，以便用來選取要由連接器同步處理的使用者。
您必須以 Active Directory 篩選器的形式指定值。
例如，此參數的下列值包含在 指定名稱 開頭 a 為 的同步處理使用者中：
(givenname=a*)
| Type: | System.String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | System.Management.Automation.SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
None.
您無法使用管線傳送輸入至此 Cmdlet。
輸出
None.
此 Cmdlet 不會產生任何輸出。