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.

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