Add-SPProfileSyncConnection
**適用先:**SharePoint Server 2016
同期接続を追加します。
構文
Add-SPProfileSyncConnection -ConnectionDomain <String> -ConnectionForestName <String> -ConnectionPassword <SecureString> -ConnectionUserName <String> -ProfileServiceApplication <SPServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-ConnectionClaimIDMapAttribute <String>] [-ConnectionClaimProviderIdValue <String>] [-ConnectionClaimProviderTypeValue <String>] [-ConnectionFilterOutUnlicensed <$true | $false>] [-ConnectionNamingContext <String>] [-ConnectionPort <Int32>] [-ConnectionServerName <String>] [-ConnectionSynchronizationOU <String>] [-ConnectionUseDisabledFilter <$true | $false>] [-ConnectionUseSSL <$true | $false>] [-WhatIf [<SwitchParameter>]]
例
---------- 例 -----------
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 ドメインからユーザーを追加します。
解説
このコマンドレットは、SharePoint Server 2010 Service Pack 1 (SP1) と SharePoint Foundation 2010 Service Pack 1 (SP1) で導入されました。
Add-SPProfileSyncConnection を使用して、ユーザー プロファイルの同期接続を追加します。
プロファイル同期接続に関する詳しい情報については、「SharePoint Server 2013 のプロファイル同期の概要」を参照してください。
注意
このコマンドレットは、Active Directory 同期接続のみで動作します。
Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「Windows PowerShell for SharePoint Server 2016 リファレンス」のオンライン ドキュメントをご覧ください。
パラメーター
パラメーター | 必須 | 種類 | 説明 |
---|---|---|---|
ConnectionDomain |
必須 |
System.String |
接続先ドメインの NetBIOS 名を指定します。 |
ConnectionForestName |
必須 |
System.String |
接続先フォレストの完全修飾ドメイン名 (FQDN) を指定します。 |
ConnectionPassword |
必須 |
System.Security.SecureString |
ディレクトリ接続に使用するアカウントのパスワードを指定します。 |
ConnectionUserName |
必須 |
System.String |
同期接続に使用するユーザー名を指定します。 |
ProfileServiceApplication |
必須 |
Microsoft.SharePoint.PowerShell.SPServiceApplicationPipeBind |
User Profile Service アプリケーションの名前を指定します。 |
AssignmentCollection |
省略可 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
適切な破棄を行うためにオブジェクトを管理します。SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
メモ:
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
|
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドを実行する前に、確認のメッセージを表示します。詳細を表示するには、「get-help about_commonparameters」と入力します。 |
ConnectionClaimIDMapAttribute |
省略可能 |
System.String |
クレーム プロバイダーで使用するクレーム ID (samAccountName) を指定します。 |
ConnectionClaimProviderIdValue |
省略可能 |
System.String |
Web App の構成時に、認証の種類に対してクレーム プロバイダーの ID または名前を指定します。 |
ConnectionClaimProviderTypeValue |
省略可能 |
System.String |
ユーザー プロファイルのアカウント名をエンコードする際に使用するクレーム認証プロバイダー (Windows/Forms など) を指定します。これにより、ユーザーが指定された認証の種類を使用してログインする場合に、クレームのエンコードされた資格情報を調べてプロファイルを検索できます。 |
ConnectionFilterOutUnlicensed |
省略可能 |
System.Boolean |
PARAMVALUE: $true | $false |
ConnectionNamingContext |
省略可能 |
System.String |
接続先ディレクトリ情報ツリーの名前付けコンテキストを指定します。 |
ConnectionPort |
省略可能 |
System.Int32 |
ディレクトリ サービスへの接続に使用するポートを指定します。既定のポートは 389 です。 |
ConnectionServerName |
省略可能 |
System.String |
接続先ドメイン コントローラーの名前を指定します。 |
ConnectionSynchronizationOU |
省略可能 |
System.String |
同期するトップレベルの組織単位 (OU) を指定します。この値はドメイン名である必要があり、1 つのコマンドに指定できるコンテナーは 1 つだけです。 |
ConnectionUseDisabledFilter |
省略可能 |
System.Boolean |
PARAMVALUE: $true | $false |
ConnectionUseSSL |
省略可能 |
System.Boolean |
ディレクトリ サービスへの接続を SSL 経由で行う必要があるかどうかを指定します。 有効な値は、$True または $False です。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。詳細を表示するには、「get-help about_commonparameters」と入力します。 |