Add-SPProfileSyncConnection
**적용 대상:**SharePoint Server 2016
**마지막으로 수정된 항목:**2015-10-06
동기화 연결을 추가합니다.
구문
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 도메인의 사용자를 추가합니다.
자세한 정보
이 cmdlet은 SharePoint Server 2010 서비스 팩 1(SP1) 및 SharePoint Foundation 2010 서비스 팩 1(SP1)에 처음 도입되었습니다.
Add-SPProfileSyncConnection cmdlet을 사용하여 사용자 프로필 동기화 연결을 추가합니다.
프로필 동기화 연결에 대한 자세한 내용은 SharePoint Server 2013의 프로필 동기화 개요를 참조하십시오.
참고
이 cmdlet은 Active Directory 동기화 연결에 대해서만 작동합니다.
Windows PowerShell for SharePoint 제품에 대한 사용 권한 및 최신 정보는 온라인 설명서(Windows PowerShell for SharePoint Server 2016 reference)를 참조하세요.
매개 변수
매개 변수 | 필수 | 종류 | 설명 |
---|---|---|---|
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 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.
참고:
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(조직 구성 단위)를 지정합니다. 값은 도메인 이름이어야 하며 컨테이너는 명령당 하나만 포함할 수 있습니다. |
ConnectionUseDisabledFilter |
선택 |
System.Boolean |
PARAMVALUE: $true | $false |
ConnectionUseSSL |
선택 |
System.Boolean |
SSL을 통해 디렉터리 서비스에 연결할지를 지정합니다. 유효한 값은 $True 또는 $False입니다. |
WhatIf |
옵션 |
System.Management.Automation.SwitchParameter |
명령을 실행하는 대신에 명령의 효과를 설명하는 메시지를 표시합니다. 자세한 내용을 보려면 get-help about_commonparameters 명령을 입력하세요. |