Add-SPProfileSyncConnection

リファレンス

モジュール:: SharePointServer

適用対象:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

同期接続を追加します。

構文

Add-SPProfileSyncConnection
   [-ProfileServiceApplication] <SPServiceApplicationPipeBind>
   -ConnectionDomain <String>
   -ConnectionForestName <String>
   -ConnectionPassword <SecureString>
   -ConnectionSynchronizationOU <String>
   -ConnectionUserName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-ConnectionClaimIDMapAttribute <String>]
   [-ConnectionClaimProviderIdValue <String>]
   [-ConnectionClaimProviderTypeValue <String>]
   [-ConnectionNamingContext <String>]
   [-ConnectionPort <Int32>]
   [-ConnectionServerName <String>]
   [-ConnectionUseSSL <Boolean>]
   [-WhatIf]
   [-ConnectionFilterOutUnlicensed <Boolean>]
   [-ConnectionUseDisabledFilter <Boolean>]
   [<CommonParameters>]

説明

このコマンドレットは、SharePoint Server with Service Pack 1 (SP1) と SharePoint Foundation with Service Pack 1 (SP1) で導入されました。

Add-SPProfileSyncConnection を使用して、ユーザープロファイルの同期接続を追加します。

プロファイル同期接続の詳細については、次を参照してください。

このコマンドレットは、Active Directory 同期接続のみで動作します。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンラインドキュメントをご覧ください。

例

---------- 例 -----------

Add-SPProfileSyncConnection -ProfileServiceApplication 888ds256-9ad9-53a9-f135-99eecd245670b -ConnectionForestName "fabrikam.com"-ConnectionDomain "Fabrikam" -ConnectionUserName "Testupa" -ConnectionPassword convertto-securestring "Password1" -asplaintext -force -ConnectionSynchronizationOU "OU=SharePoint Users,DC=fabrikam,DC=com"

この例では、特定の User Profile Service アプリケーションを使用して fabrikam ドメインからユーザーを追加します。

パラメーター

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバルストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

コマンドを実行する前に確認メッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionClaimIDMapAttribute

クレームプロバイダーで使用するクレーム ID (samAccountName) を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionClaimProviderIdValue

Web App の構成時に、認証の種類に対してクレームプロバイダーの ID または名前を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionClaimProviderTypeValue

ユーザープロファイルのアカウント名をエンコードする際に使用するクレーム認証プロバイダー (Windows/Forms など) を指定します。これにより、ユーザーが指定された認証の種類を使用してログインする場合に、クレームのエンコードされた資格情報を調べてプロファイルを検索できます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionDomain

接続先ドメインの NetBIOS 名を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionFilterOutUnlicensed

使用しないでください。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionForestName

接続先フォレストの完全修飾ドメイン名 (FQDN) を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionNamingContext

接続先ディレクトリ情報ツリーの名前付けコンテキストを指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionPassword

ディレクトリ接続に使用するアカウントのパスワードを指定します。

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionPort

ディレクトリサービスへの接続に使用するポートを指定します。既定のポートは 389 です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionServerName

接続先ドメインコントローラーの名前を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionSynchronizationOU

同期するトップレベルの組織単位 (OU) を指定します。この値はドメイン名である必要があり、1 つのコマンドに指定できるコンテナーは 1 つだけです。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionUseDisabledFilter

無効なアカウントを除外します。

注:

これにより、インポートされる前に無効状態になっているアカウントのみが除外されます。インポート後に無効にされたアカウントは除外されません。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionUserName

同期接続に使用するユーザー名を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConnectionUseSSL

ディレクトリサービスへの接続を SSL 経由で行う必要があるかどうかを指定します。

有効な値は、$True または $False です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ProfileServiceApplication

User Profile Service アプリケーションの名前を指定します。

Type:	SPServiceApplicationPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

次の方法で共有