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 コマンドレットは、Service Manager Active Directory コネクタを作成します。
次のパラメーターは、2012 R2 更新プログラムロールアップ 6 以降のバージョンService Manager適用している場合にのみ使用できます。
- 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 変数に格納します。
2 番目のコマンドでは、Get-Credential コマンドレットを使用して資格情報の入力を求め、資格情報を $Credential 変数に格納します。
最後のコマンドは、すべてのコンピューター、プリンター、ユーザー、およびユーザー グループを取得するローカル ドメインへの Active Directory コネクタを作成します。 コネクタは、毎週日曜日の午前 3 時に同期するように構成されています。
例 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 変数に格納します。
2 番目のコマンドでは、Get-Credential コマンドレットを使用して資格情報の入力を求め、資格情報を $Credential 変数に格納します。
最後のコマンドは、文字 E で始まるユーザー アカウントのみを取得するローカル ドメインへの Active Directory コネクタを作成します。
パラメーター
-ADCredential
このコマンドレットがドメイン コントローラーに接続するときに使用する資格情報を指定します。
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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
このコマンドレットが 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
このコマンドレットでコネクタを有効または無効にするかどうかを示します。
Type: | System.Boolean |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpandGroups
このコマンドレットに 、UserFilter パラメーターで指定されたグループのメンバーが再帰的に含まれていることを指定します。
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
このコマンドレットは、作成した Active Directory コネクタを返します。 このオブジェクトを他のコマンドレットに渡すことができます。
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrinterFilter
コネクタが同期するプリンターを選択するためにこのコマンドレットで使用するフィルターを指定します。
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryRoot
LDAP://DC=scsm、DC=stbtest、DC=microsoft、DC=com など、このコマンドレットがオブジェクトを照会する Active Directory フォルダーを指定します。
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 フィルターの形式で値を指定する必要があります。
たとえば、このパラメーターの次の値は、 givenName が で始まる a
同期ユーザーに 含まれています。
(givenname=a*)
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
None.
パイプを使用してこのコマンドレットに入力を渡すことはできません。
出力
None.
このコマンドレットは出力を生成しません。