New-SCADConnector

モジュール:

System.Center.Service.Manager

新しい 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 コネクタを作成します。

次のパラメーターは、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 コマンドレットを使用して、ワークフロー アカウントの実行アカウントを取得します。 このコマンドは、結果を $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 変数に格納します。

最後のコマンドでは、ローカル ドメインへの Active Directory コネクタが作成され、文字 E で始まるユーザー アカウントのみが取得されます。

パラメーター

-ADCredential

このコマンドレットがドメイン コントローラーに接続するときに使用する資格情報を指定します。

型:	System.Management.Automation.PSCredential
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ComputerFilter

コネクタが同期するコンピューターを選択するフィルターを指定します。 フィルターは、Active Directory フィルターとして指定する必要があります。 たとえば、次のフィルターには、同期で win で始まるすべてのコンピューターが含まれます。

(name=win*)

型:	System.String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ComputerName

System Center Data Access サービスを実行するコンピューターの名前を指定します。 Credential パラメーターで指定されたユーザー アカウントには、指定したコンピューターへのアクセス権が必要です。

型:	System.String[]
配置:	Named
規定値:	Localhost
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:	System.Management.Automation.SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Credential

このコマンドレットが System Center Data Access サービスを実行するサーバーへの接続に使用する資格情報を指定します。 指定されたユーザー アカウントには、そのサーバーへのアクセス権が必要です。

型:	System.Management.Automation.PSCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

コネクタの説明を指定します。

型:	System.String
配置:	1
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisplayName

コネクタの表示名プロパティを指定します。

型:	System.String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Enable

このコマンドレットでコネクタを有効または無効にするかどうかを示します。

型:	System.Boolean
配置:	Named
規定値:	True
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExpandGroups

このコマンドレットに、UserFilter パラメーターで指定されたグループのメンバーが再帰的に含まれていることを指定します。

型:	System.Management.Automation.SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

このコマンドレットによって、作成された Active Directory コネクタが返されることを示します。 このオブジェクトは、他のコマンドレットに渡すことができます。

型:	System.Management.Automation.SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PrinterFilter

コネクタが同期するプリンターを選択するためにこのコマンドレットが使用するフィルターを指定します。

型:	System.String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-QueryRoot

LDAP://DC=scsm、DC=stbtest、DC=microsoft、DC=com など、このコマンドレットがオブジェクトを照会する Active Directory フォルダーを指定します。

型:	System.String
配置:	2
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RunAsAccount

このコネクタを使用するときに使用する RunAs アカウントを指定します。

型:	Microsoft.EnterpriseManagement.Configuration.ManagementPackSecureReference
配置:	3
規定値:	Operational System Account
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScheduleDay

コネクタが同期する曜日を指定します。 有効な値は次のとおりです。

• 日毎
• 日曜日
• 月曜日
• 火曜日
• 水曜日
• 木曜日
• 金曜日
• 土曜日

型:	Microsoft.EnterpriseManagement.ServiceManager.Sdk.Connectors.DaySchedule
指定可能な値:	Daily, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
配置:	Named
規定値:	Daily
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScheduleHour

コネクタが同期を開始する時間を指定します。 値は、ゼロ (0) から 23 までの数値である必要があります。

型:	System.Int32
配置:	Named
規定値:	2
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SCSession

Service Manager 管理サーバーへのセッションを表すオブジェクトを指定します。

型:	Microsoft.SystemCenter.Core.Connection.Connection[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SyncNow

Active Directory コネクタが同期サイクルを開始します。

型:	System.Management.Automation.SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserFilter

コネクタによって同期されるユーザーの選択に使用するフィルターを指定します。 Active Directory フィルターの形式で値を指定する必要があります。 たとえば、このパラメーターの次の値は、givenName が aで始まる同期ユーザーに含まれます。

(givenname=a*)

型:	System.String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:	System.Management.Automation.SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None.

このコマンドレットに入力をパイプすることはできません。

出力

None.

このコマンドレットは出力を生成しません。

関連リンク

• New-SCCMConnector
• New-SCOMAlertConnector
• New-SCOMConfigurationItemConnector
• New-SCOrchestratorConnector
• New-SCVMMConnector