서비스 응용 프로그램을 SharePoint Server 구독 버전으로 업그레이드

적용 대상:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

SharePoint Server 2019 또는 SharePoint Server 2016에서 SharePoint Server 구독 버전으로 업그레이드하는 경우 데이터베이스 연결 업그레이드를 사용해야 합니다. 즉, 구성 설정이 아닌 환경에 대한 콘텐츠만 업그레이드합니다. SharePoint Server 구독 버전 환경을 구성하고 콘텐츠 및 서비스 애플리케이션 데이터베이스를 복사한 후 서비스 애플리케이션을 SharePoint Server 구독 버전으로 업그레이드할 수 있습니다. 이 문서에는 서비스 응용 프로그램을 업그레이드하기 위해 수행하는 단계가 포함됩니다.

업그레이드 프로세스 3단계: 서비스 응용 프로그램 업그레이드

단계

설명

SharePoint Server 2019 및 SharePoint Server 2016 데이터 및 사이트를 SharePoint Server 구독 버전으로 업그레이드하는 프로세스의 세 번째 단계입니다. 이 프로세스에는 아래에 나와 있는 순서대로 수행해야 하는 다음 단계가 포함됩니다. 데이터베이스 연결 업그레이드를 위한 SharePoint Server 구독 버전 팜 만들기 SharePoint Server 구독 버전으로 업그레이드하기 위해 새 팜에 데이터베이스 복사 서비스 애플리케이션을 SharePoint Server 구독 버전으로 업그레이드 (이 단계) SharePoint Server로 콘텐츠 데이터베이스 업그레이드 전체 프로세스에 대한 개요는 SharePoint Server 구독 버전으로 업그레이드 프로세스 개요를 참조하세요.

시작하기 전에

서비스 응용 프로그램을 업그레이드하기 전에 다음 정보를 검토하고 권장 조치를 수행하세요.

• 이 문서의 단계를 수행하는 데 사용하는 계정이 중앙 관리 웹 사이트의 팜 관리자 그룹의 구성원인지 확인합니다.

• 업그레이드된 서비스 응용 프로그램에 대해 사용할 서비스 응용 프로그램 풀을 결정합니다. 아래 절차에서는 "SharePoint Web Services 기본값"인 서비스 응용 프로그램에 대한 기본 응용 프로그램 풀이 사용됩니다. PowerShell에서 Get-SPServiceApplicationPool cmdlet을 사용하여 사용 가능한 서비스 응용 프로그램 풀 목록을 볼 수 있습니다. 또한 New-SPServiceApplicationPool cmdlet을 사용하여 서비스 응용 프로그램 풀을 만들 수 있습니다. 자세한 내용은 Get-SPServiceApplicationPool 및 New-SPServiceApplicationPool을 참조하세요.

팁

이 문서 전체에서는 시간 및 노력을 아끼기 위해 PowerShell cmdlet에서 $applicationPool, $sss, $upa와 같은 변수가 사용됩니다. 원하지 않을 경우에는 이러한 변수를 사용하지 않아도 됩니다. 그러나 이러한 변수를 사용하지 않는 경우 ID 매개 변수를 지정할 때 서비스 애플리케이션 및 서비스 애플리케이션 프록시에 ID를 사용해야 합니다. 각 절차에는 사용되는 변수에 대한 정보가 포함되거나 필요한 ID를 조회하기 위해 사용할 수 있는 대체 cmdlet이 포함됩니다. > 또한 이 문서의 많은 절차에는 $applicationPool 변수를 설정하는 단계가 포함되어 있습니다. 이러한 모든 절차를 PowerShell의 동일 세션에서 수행하고 모든 서비스 응용 프로그램에 대해 동일한 응용 프로그램을 사용하려는 경우에는 각 절차에서 이 단계를 반복할 필요가 없습니다. 대신 시작할 때 이 변수를 한 번만 설정하고 이 문서의 전체 절차에서 계속 사용할 수 있습니다.

서비스 응용 프로그램 데이터베이스 업그레이드

서비스 응용 프로그램 데이터베이스를 업그레이드하려면 새 서비스 응용 프로그램을 만든 다음 새 서비스 응용 프로그램에 사용할 기존 데이터베이스의 이름을 지정합니다. 서비스 응용 프로그램을 만들면 데이터베이스가 업그레이드됩니다. 이 프로세스에서는 다음과 같은 여러 단계를 수행합니다.

참고

Word Automation Services 및 Machine Translation Services는 업그레이드할 수 없습니다. 새 서비스 인스턴스를 만들어야 합니다.

중요

다음 단계는 사용자 지정 서버 역할 유형에만 적용됩니다. 서버 역할 유형에 대한 자세한 내용은 SharePoint Server 2016 및 SharePoint Server 2019에서 MinRole 서버 배포 계획을 참조하세요.

1. 서비스 인스턴스를 시작합니다.

   첫 번째 단계는 비즈니스 데이터 연결 서비스, 관리되는 메타데이터 웹 서비스, 보안 저장소 서비스 및 검색 서비스 등 업그레이드할 수 있는 네 가지 서비스 애플리케이션에 대한 서비스 인스턴스를 시작하는 것입니다. 이러한 서비스 인스턴스는 대부분 중앙 관리에서 시작할 수 있습니다. 그러나 SharePoint Server Search Service 인스턴스는 PowerShell을 사용하여 시작해야 합니다.

2. 서비스 애플리케이션을 만들고 데이터베이스를 업그레이드합니다.

   서비스 인스턴스를 시작한 후에는 서비스 응용 프로그램을 만들고 데이터베이스를 업그레이드합니다. PowerShell을 사용하여 서비스 응용 프로그램 데이터베이스를 복원해야 합니다.

3. 서비스 애플리케이션에 대한 프록시를 만듭니다.

   서비스 응용 프로그램 데이터베이스를 업그레이드한 후에는 서비스 응용 프로그램용 프록시를 만든 다음 기본 프록시 그룹에 추가합니다. 다음 서비스 응용 프로그램에 대해 프록시를 만들어야 합니다.

   • Managed Metadata Service 응용 프로그램

   • Search Service 응용 프로그램

   • Secure Store 서비스 응용 프로그램

     Business Data Connectivity 서비스 응용 프로그램은 서비스 응용 프로그램을 만들 때 자동으로 프록시를 만들어 기본 프록시 그룹에 할당합니다.

4. 프록시가 기본 그룹에 있는지 확인

다음 섹션에서 이러한 단계를 완료하기 위한 절차를 제공합니다.

서비스 인스턴스 시작

다음 절차에 따라 서비스 인스턴스를 시작합니다.

중앙 관리에서 서비스 응용 프로그램 인스턴스를 시작하려면

1. SharePoint 2019 중앙 관리를 시작합니다.

2. SharePoint 2019 중앙 관리의 애플리케이션 관리 페이지의 서비스 애플리케이션 섹션에서 서버의 서비스 관리를 클릭합니다.

3. Business Data Connectivity 서비스 옆의 시작을 클릭합니다.

4. 관리되는 메타데이터 웹 서비스 옆의 시작을 클릭합니다.

5. Secure Store 서비스 옆의 시작을 클릭합니다.

Search Service 인스턴스는 Search Service 응용 프로그램이 이미 있는 경우가 아니면 중앙 관리에서 시작할 수 없으므로 PowerShell을 사용하여 시작해야 합니다.

팁

MinRoles를 사용하는 경우 팜에서 관리하므로 시작을 사용할 수 없습니다. 연결된 서비스 애플리케이션이 만들어지면 서비스 인스턴스가 자동으로 시작됩니다.

PowerShell을 사용하여 Search Service 인스턴스를 시작하려면

1. 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

     관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 구독 버전 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

     참고

     권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

2. SharePoint 구독 버전 관리 셸을 시작합니다.

3. Search Service 인스턴스를 시작하려면 Microsoft PowerShell 명령 프롬프트에 다음 명령을 입력하고 각 명령 끝에서 Enter 키를 누릅니다.

   $SearchInst = Get-SPEnterpriseSearchServiceInstance
       # Stores the identity for the Search service instance on this server as a variable
   

   Start-SPServiceInstance $SearchInst
       # Starts the service instance
   

   자세한 내용은 Get-SPEnterpriseSearchServiceInstance 및 Start-SPServiceInstance를 참조하세요.

Secure Store 서비스 응용 프로그램 업그레이드

Secure Store Service 응용 프로그램을 업그레이드하려면 새 서비스 응용 프로그램을 만들고 데이터베이스를 업그레이드한 다음 프록시를 만들어 기본 프록시 그룹에 추가하고 이전 환경에서 암호를 복원합니다.

PowerShell을 사용하여 Secure Store서비스 응용 프로그램을 업그레이드하려면

1. 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

     관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server cmdlet 사용 권한을 부여할 수 있습니다.

     참고

     권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

2. SharePoint 구독 버전 관리 셸을 시작합니다.

3. 사용하려는 응용 프로그램 풀을 이 서비스 응용 프로그램의 변수로 저장하려면 Microsoft PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

   $applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
   

   여기서 각 부분이 나타내는 의미는 다음과 같습니다.

   • SharePoint Web Services default는 새 서비스 응용 프로그램을 포함할 서비스 응용 프로그램 풀의 이름입니다. 이 풀은 기본 서비스 응용 프로그램 풀입니다. 다른 서비스 응용 프로그램 풀을 지정할 수 있습니다.

   이 cmdlet은 서비스 응용 프로그램 풀을 이후에 사용하는 cmdlet에서 다시 사용할 수 있는 변수로 설정합니다. 응용 프로그램 풀이 여러 개 있는데 특정 서비스 응용 프로그램에 대해 다른 응용 프로그램 풀을 사용하려는 경우에는 절차에서 이 단계를 반복하여 적절한 응용 프로그램을 사용할 수 있도록 각 서비스 응용 프로그램을 만듭니다.

4. Secure Store 서비스 애플리케이션을 업그레이드하려면 PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

   $sss = New-SPSecureStoreServiceApplication -Name 'Secure Store' -ApplicationPool $applicationPool -DatabaseName 'SecureStore_Upgrade_DB' -AuditingEnabled
   

   여기서,

   • SecureStore는 새 Secure Store Service 응용 프로그램에 지정할 이름입니다.

   • $applicationpool은 사용할 서비스 응용 프로그램 풀을 식별하기 위해 이전에 설정한 변수입니다.

     팁

     $applicationPool 변수를 사용하지 않을 경우에는 ' Application Pool Name' 형식으로 기존 서비스 응용 프로그램 풀의 이름을 지정해야 합니다. 서비스 응용 프로그램 풀 목록을 보려면 Get-SPServiceApplicationPool cmdlet을 실행하면 됩니다.

   • SecureStore_Upgrade_DB는 업그레이드할 서비스 응용 프로그램 데이터베이스의 이름입니다.

   이 명령은 나중에 프록시를 만들 때 사용하는 변수인 $sss를 설정합니다.

   자세한 내용은 New-SPSecureStoreApplication을 참조하세요.

5. 다음 명령을 입력하여 Secure Store 서비스 응용 프로그램의 프록시를 만듭니다.

   $sssp = New-SPSecureStoreServiceApplicationProxy -Name ProxyName -ServiceApplication $sss -DefaultProxyGroup
   

   여기서 각 부분이 나타내는 의미는 다음과 같습니다.

   • ProxyName은 사용할 프록시 이름입니다.

   • $sss는 새 Secure Store Service 응용 프로그램을 식별하기 위해 이전에 설정한 변수입니다.

     팁

     $sss 변수를 사용하지 않는 경우에는 이름 대신 ID를 사용하여 Secure Store Service 응용 프로그램을 식별해야 합니다. ID를 찾으려면 Get-SPServiceApplication cmdlet을 실행하여 모든 서비스 응용 프로그램 ID 목록을 반환하면 됩니다.

   • DefaultProxyGroup은 Secure Store Service 응용 프로그램 프록시를 로컬 팜의 기본 프록시 그룹에 추가합니다.

   이 명령은 암호를 복원할 때 사용하는 서비스 응용 프로그램 프록시의 $sssp 변수를 설정합니다.

   자세한 내용은 New-SPSecureStoreServiceApplicationProxy를 참조하세요.

   Secure Store Service 응용 프로그램과 프록시를 만든 후에는 암호화 키를 새로 고쳐야 합니다. 암호화 키를 새로 고치는 방법에 대한 자세한 내용은 보안 저장소 암호화 키 새로 고침을 참조하세요.

6. 다음 명령을 입력하여 Secure Store 서비스 응용 프로그램의 암호를 복원합니다.

   Update-SPSecureStoreApplicationServerKey -Passphrase <Passphrase> -ServiceApplicationProxy $sssp
   

   여기서 각 부분이 나타내는 의미는 다음과 같습니다.

   • <Passphrase>는 이전 환경의 Secure Store Service 응용 프로그램 암호입니다.

   • $sssp는 새 Secure Store Service 응용 프로그램을 식별하기 위해 이전에 설정한 변수입니다.

     팁

     $sssp 변수를 사용하지 않는 경우에는 이름 대신 ID를 사용하여 Secure Store Service 응용 프로그램을 식별해야 합니다. ID를 찾으려면 Get-SPServiceApplicationProxy cmdlet을 실행하여 모든 서비스 응용 프로그램 프록시 ID 목록을 반환하면 됩니다.

   자세한 내용은 Update-SPSecureStoreApplicationServerKey를 참조하세요.

Business Data Connectivity 서비스 응용 프로그램 업그레이드

Business Data Connectivity 서비스 응용 프로그램을 업그레이드하려면 새 서비스 응용 프로그램을 만들고 데이터베이스를 업그레이드합니다. Business Data Connectivity 서비스 응용 프로그램의 프록시는 만들지 않아도 됩니다. Business Data Connectivity 서비스 응용 프로그램은 서비스 응용 프로그램을 만들 때 자동으로 프록시를 만들어 기본 프록시 그룹에 할당합니다.

PowerShell을 사용하여 Business Data Connectivity 서비스 응용 프로그램을 업그레이드하려면

1. 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

     관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 2019 또는 SharePoint Server 2016 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

     참고

     권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

2. SharePoint 구독 버전 관리 셸을 시작합니다.

3. 사용하려는 응용 프로그램 풀을 이 서비스 응용 프로그램의 변수로 저장하려면 Microsoft PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

   $applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
   

   여기서 각 부분이 나타내는 의미는 다음과 같습니다.

   • SharePoint Web Services default는 새 서비스 응용 프로그램을 포함할 서비스 응용 프로그램 풀의 이름입니다.

   이 cmdlet은 서비스 응용 프로그램 풀을 이후에 사용하는 cmdlet에서 다시 사용할 수 있는 변수로 설정합니다. 응용 프로그램 풀이 여러 개 있는데 특정 서비스 응용 프로그램에 대해 다른 응용 프로그램 풀을 사용하려는 경우에는 절차에서 이 단계를 반복하여 적절한 응용 프로그램을 사용할 수 있도록 각 서비스 응용 프로그램을 만듭니다.

4. Business Data Connectivity 서비스 응용 프로그램을 업그레이드하려면 Microsoft PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

   New-SPBusinessDataCatalogServiceApplication -Name 'BDC Service' -ApplicationPool $applicationPool -DatabaseName 'BDC_Service_DB'
   

   여기서 각 부분이 나타내는 의미는 다음과 같습니다.

   • BDC Service는 새 Business Data Connectivity 서비스 응용 프로그램에 지정할 이름입니다.

   • $applicationpool은 사용할 서비스 응용 프로그램 풀을 식별하기 위해 이전에 설정한 변수입니다.

     팁

     $applicationPool 변수를 사용하지 않을 경우에는 ' Application Pool Name' 형식으로 기존 서비스 응용 프로그램 풀의 이름을 지정해야 합니다. 서비스 응용 프로그램 풀 목록을 보려면 Get-SPServiceApplicationPool cmdlet을 실행하면 됩니다.

   • BDC_Service_DB는 업그레이드할 서비스 응용 프로그램 데이터베이스의 이름입니다.

   자세한 내용은 New-SPBusinessDataCatalogServiceApplication을 참조하세요.

Managed Metadata Service 응용 프로그램 업그레이드

Managed Metadata Service 응용 프로그램을 업그레이드하려면 새 서비스 응용 프로그램을 만들고 데이터베이스를 업그레이드한 다음 프록시를 만들어 기본 프록시 그룹에 추가합니다.

PowerShell을 사용하여 Managed Metadata Service 응용 프로그램을 업그레이드하려면

1. 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

     관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 2019 또는 SharePoint Server 2016 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

     참고

     권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

2. SharePoint 구독 버전 관리 셸을 시작합니다.

3. 이 서비스 애플리케이션의 변수로 사용하려는 애플리케이션 풀을 저장하려면 PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

   $applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
   

   여기서,

   • SharePoint Web Services default는 새 서비스 응용 프로그램을 포함할 서비스 응용 프로그램 풀의 이름입니다.

   이 cmdlet은 서비스 응용 프로그램 풀을 이후에 사용하는 cmdlet에서 다시 사용할 수 있는 변수로 설정합니다. 응용 프로그램 풀이 여러 개 있는데 특정 서비스 응용 프로그램에 대해 다른 응용 프로그램 풀을 사용하려는 경우에는 절차에서 이 단계를 반복하여 적절한 응용 프로그램을 사용할 수 있도록 각 서비스 응용 프로그램을 만듭니다.

4. 관리되는 메타데이터 서비스 애플리케이션을 업그레이드하려면 PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

   $mms = New-SPMetadataServiceApplication -Name 'Managed Metadata Service Application' -ApplicationPool $applicationPool -DatabaseName 'Managed Metadata Service_DB'
   

   여기서,

   • Managed Metadata Service Application은 새 Managed Metadata Service 응용 프로그램에 지정할 이름입니다.

   • $applicationpool은 사용할 서비스 응용 프로그램 풀을 식별하기 위해 이전에 설정한 변수입니다.

     팁

     $applicationPool 변수를 사용하지 않을 경우에는 ' Application Pool Name' 형식으로 기존 서비스 응용 프로그램 풀의 이름을 지정해야 합니다. 서비스 응용 프로그램 풀 목록을 보려면 Get-SPServiceApplicationPool cmdlet을 실행하면 됩니다.

   • Managed Metadata Service_DB는 업그레이드할 서비스 응용 프로그램 데이터베이스의 이름입니다.

     이 명령은 나중에 프록시를 만들 때 사용하는 변수인 $mms를 설정합니다.

   자세한 내용은 New-SPMetadataServiceApplication을 참조하세요.

5. PowerShell 명령 프롬프트에서 다음 명령을 입력하여 관리되는 메타데이터 서비스 애플리케이션에 대한 프록시를 만듭니다.

   New-SPMetadataServiceApplicationProxy -Name ProxyName -ServiceApplication $mms -DefaultProxyGroup
   

   여기서,

   • ProxyName은 사용할 프록시 이름입니다.

   • $mms는 새 Managed Metadata Service 응용 프로그램을 식별하기 위해 이전에 설정한 변수입니다.

     팁

     $mms 변수를 사용하지 않는 경우에는 이름 대신 ID를 사용하여 Managed Metadata Service 응용 프로그램 프록시를 식별해야 합니다. ID를 찾으려면 Get-SPServiceApplication cmdlet을 실행하여 모든 서비스 응용 프로그램 ID 목록을 반환하면 됩니다.

   • DefaultProxyGroup은 Managed Metadata Service 응용 프로그램 프록시를 로컬 팜의 기본 프록시 그룹에 추가합니다.

   자세한 내용은 New-SPMetadataServiceApplicationProxy를 참조하세요.

User Profile Service 응용 프로그램 업그레이드

사용자 프로필 서비스 애플리케이션을 업그레이드하기 전에 관리되는 메타데이터 서비스 애플리케이션을 업그레이드합니다.

사용자 프로필 서비스 애플리케이션을 업그레이드하려면 SharePoint Server 2019 또는 SharePoint Server 2016 팜의 프로필 및 소셜 데이터베이스를 SharePoint Server 구독 버전 팜으로 복사하고 SharePoint Server 2019 또는 SharePoint Server 2016 팜의 SharePoint Server 구독 버전 팜에서 새 사용자 프로필 서비스 애플리케이션을 만듭니다. 복원은 SharePoint Server 구독 버전을 트리거하여 SharePoint Server 구독 버전 팜에 새 사용자 프로필 서비스 애플리케이션을 만들고 복사한 사용자 프로필 데이터베이스를 가리킵니다. 사용자 프로필 서비스 애플리케이션의 업그레이드를 완료하려면 프록시를 만들고 기본 프록시 그룹에 추가합니다.

PowerShell을 사용하여 사용자 프로필 서비스 애플리케이션을 업그레이드하려면

1. 다음 단계에 따라 SharePoint Server 2019 또는 SharePoint Server 2016 팜의 프로필 및 소셜 데이터베이스를 SharePoint Server 구독 버전 팜에 복사합니다.

   중요

   SharePoint Server 2019 및 SharePoint Server 2016 환경에서 다음 단계를 수행합니다.

   • 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

     관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 2019 또는 SharePoint Server 2016 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

     참고

     권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

   • SharePoint 관리 셸을 시작합니다.

   • 사용자 프로필 데이터베이스를 읽기 전용으로 설정합니다. SharePoint Server 2019 또는 SharePoint Server 2016 데이터 및 사이트를 SharePoint Server 구독 버전으로 업그레이드하는 프로세스의 두 번째 단계에서는 다른 모든 데이터베이스를 읽기 전용으로 설정합니다.

   • SharePoint Server 2019 또는 SharePoint Server 2016 팜의 프로필 및 소셜 데이터베이스를 SharePoint Server 구독 버전 팜에 복사하고, SharePoint Server 구독 버전으로 업그레이드하기 위해 데이터베이스를 새 팜으로 복사의 절차를 따릅니다.

     중요

     SharePoint Server 구독 버전 환경에서 다음 단계를 수행합니다.

2. 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

   관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 2019 또는 SharePoint Server 2016 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

   참고

   권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

3. SharePoint 구독 버전 관리 셸을 시작합니다.

4. 사용하려는 응용 프로그램 풀을 이 서비스 응용 프로그램의 변수로 저장하려면 Microsoft PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

   $applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
   

   여기서 각 부분이 나타내는 의미는 다음과 같습니다.

   SharePoint Web Services default는 새 서비스 응용 프로그램을 포함할 서비스 응용 프로그램 풀의 이름입니다.

   이 cmdlet은 서비스 응용 프로그램 풀을 이후에 사용하는 cmdlet에서 다시 사용할 수 있는 변수로 설정합니다. 응용 프로그램 풀이 여러 개 있는데 특정 서비스 응용 프로그램에 대해 다른 응용 프로그램 풀을 사용하려는 경우에는 절차에서 이 단계를 반복하여 적절한 응용 프로그램을 사용할 수 있도록 각 서비스 응용 프로그램을 만듭니다.

5. 사용자 프로필 서비스 애플리케이션을 복원하고 프로필 및 소셜 데이터베이스를 업그레이드하려면 Microsoft PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

   New-SPProfileServiceApplication -Name '<UserProfileApplicationName>' -ApplicationPool $applicationPool -ProfileDBName '<ProfileDBName>' -SocialDBName '<SocialDBName>' -ProfileSyncDBName '<SyncDBName>'
   

   여기서,

   • UserProfileApplicationName 은 사용자 프로필 서비스 애플리케이션의 이름입니다.

   • $applicationpool은 사용할 서비스 응용 프로그램 풀을 식별하기 위해 설정한 변수입니다.

     참고

     변수 $applicationPool 사용하지 않는 경우 기존 서비스 애플리케이션 풀의 이름을 '애플리케이션 풀 이름' 형식으로 지정해야 합니다. 서비스 응용 프로그램 풀 목록을 보려면 Get-SPServiceApplicationPool cmdlet을 실행하면 됩니다.

   • ProfileDBName 은 업그레이드하려는 프로필 데이터베이스의 이름입니다.

   • SocialDBName 은 업그레이드하려는 소셜 데이터베이스의 이름입니다.

   • SyncDBName 은 새 동기화 데이터베이스의 이름입니다.

6. 사용자 프로필 서비스 애플리케이션 프록시를 만들고 다음 작업을 완료하여 기본 프록시 그룹에 추가합니다.

   • 다음 명령을 입력하여 사용자 프로필 서비스 애플리케이션의 ID를 가져와 변수로 저장합니다.

     $sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'User Profile Service Application'}
     

     자세한 내용은 Get-SPServiceApplication을 참조하세요.

   • 다음 명령을 입력하여 User Profile Service 응용 프로그램의 프록시를 만듭니다.

     New-SPProfileServiceApplicationProxy -Name 'User Profile Service Application Proxy' -ServiceApplication $sa
     

     여기서 각 부분이 나타내는 의미는 다음과 같습니다.

     • ProxyName은 사용할 프록시 이름입니다.

     • $sa 새 사용자 프로필 서비스 애플리케이션을 식별하기 위해 이전에 설정한 변수입니다.

       팁

       변수 $sa 사용하지 않는 경우 ID를 사용하여 이름 대신 사용자 프로필 서비스 애플리케이션을 식별해야 합니다. ID를 찾으려면 Get-SPServiceApplication cmdlet을 실행하여 모든 서비스 응용 프로그램 ID 목록을 반환하면 됩니다.

     자세한 내용은 New-SPProfileServiceApplicationProxy를 참조하세요.

   • 다음 명령을 입력하여 방금 만든 프록시에 대한 사용자 프로필 서비스 애플리케이션 프록시 ID를 가져와 변수 $proxy 설정합니다.

     $proxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq 'User Profile Service Application Proxy'}
     

     자세한 내용은 Get-SPServiceApplicationProxy를 참조하십시오.

   • 다음 명령을 입력하여 사용자 프로필 서비스 애플리케이션 프록시를 기본 프록시 그룹에 추가합니다.

     Add-SPServiceApplicationProxyGroupMember -member $proxy -identity ""
     

     여기서,

     • $proxy 사용자 프로필 서비스 애플리케이션에 대해 방금 만든 프록시의 ID를 식별하기 위해 이전에 설정한 변수입니다.

       팁: 변수 $proxy 사용하지 않는 경우 ID를 사용하여 이름 대신 사용자 프로필 서비스 애플리케이션 프록시를 식별해야 합니다. ID를 찾으려면 Get-SPServiceApplicationProxy cmdlet을 실행하여 모든 서비스 응용 프로그램 프록시 ID 목록을 반환하면 됩니다.

     • 빈 Identity 매개 변수("")를 사용하여 기본 그룹에 추가합니다.

     자세한 내용은 Add-SPServiceApplicationProxyGroupMember를 참조하십시오.

Search Service 응용 프로그램 업그레이드

User Profile Service 응용 프로그램 및 Managed Metadata Service 응용 프로그램을 업그레이드해야 Search Service 응용 프로그램을 업그레이드할 수 있습니다.

Search 서비스 애플리케이션을 업그레이드하려면 SharePoint Server 2019 또는 SharePoint Server 2016 팜의 검색 관리 데이터베이스를 SharePoint Server 구독 버전 팜에 복사하고 SharePoint Server 구독 버전 팜의 SharePoint Server 2019 또는 SharePoint Server 2016 팜에서 Search 서비스 애플리케이션을 복원합니다. 복원은 SharePoint Server 구독 버전을 트리거하여 SharePoint Server 구독 버전 팜에 새 Search 서비스 애플리케이션을 만들고 복사한 검색 관리 데이터베이스를 가리킵니다. Search 서비스 애플리케이션의 업그레이드를 완료하려면 프록시를 만들어 기본 프록시 그룹에 추가하고 새 링크 데이터베이스 및 새 검색 토폴로지를 SharePoint Server 2019 또는 SharePoint Server 2016 팜과 동일한 방식으로 구성해야 합니다.

SharePoint Server Subscription Edition은 일반적으로 새 Search 서비스 애플리케이션을 만들 때 모든 검색 구성 요소 및 데이터베이스를 사용하여 새 검색 토폴로지를 만듭니다. Search 서비스 애플리케이션을 복원 하는 동안 SharePoint Server 구독 버전은 새 검색 토폴로지를 만들지만 새 검색 관리 데이터베이스를 만드는 대신 복원된 검색 관리 데이터베이스를 업그레이드합니다. 업그레이드된 검색 관리 데이터베이스는 SharePoint Server 2019 또는 SharePoint Server 2016 팜의 검색 스키마, 결과 원본 및 쿼리 규칙에 대한 추가 또는 수정 사항을 유지합니다.

참고

이 업그레이드 중에 검색은 SharePoint Server 2019 또는 SharePoint Server 2016에서 콘텐츠를 크롤링하지 않습니다. 검색 결과의 최신성이 중요한 경우 업그레이드를 시작하기 전에 이러한 단계를 숙지하여 시간을 절약합니다.

중요

SharePoint Server 구독 버전 팜의 검색 토폴로지는 새 버전이므로 인덱스는 비어 있습니다. 모든 콘텐츠 원본을 업그레이드한 후 전체 인덱싱된 모음의 전체 크롤링을 수행해야 합니다(SharePoint Server 2019 및 SharePoint Server 2016 데이터 및 사이트를 SharePoint Server 구독 버전으로 업그레이드하는 프로세스의 네 번째 단계).

PowerShell을 사용하여 Search Service 응용 프로그램을 업그레이드하려면

1. SharePoint Server 2019 또는 SharePoint Server 2016 팜의 검색 관리 데이터베이스를 SharePoint Server 구독 버전 팜에 복사하고 다음 단계를 수행합니다.

   참고

   SharePoint Server 구독 버전으로 업그레이드하기 위한 프로세스의 이전 단계에서 SharePoint Server 2019 또는 SharePoint Server 2016 환경에서 다른 모든 콘텐츠 및 서비스 데이터베이스를 복사했습니다. 검색 관리 데이터베이스를 복사하는 동안 SharePoint Server 2019 또는 SharePoint Server 2016 환경에서 Search Service 애플리케이션을 일시 중지해야 하므로 이 이후 단계에서 검색 관리 데이터베이스를 복사하는 것이 좋습니다.

   중요

   SharePoint Server 2019 또는 SharePoint Server 2016 환경에서 다음 단계를 수행합니다.

   • 다음 멤버 자격이 있는지 확인합니다.

     • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

     • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

     • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

       관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 구독 버전 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

       참고

       권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

   • SharePoint 2019 또는 SharePoint 2016 관리 셸을 시작합니다.

   • Search Service 응용 프로그램을 일시 중지합니다. PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

       $ssa = Get-SPEnterpriseSearchServiceApplication <SearchServiceApplicationName>
       Suspend-SPEnterpriseSearchServiceApplication -Identity $ssa
     

     여기서 각 부분이 나타내는 의미는 다음과 같습니다.

     SearchServiceApplicationName은 일시 중지하려는 Search Service 응용 프로그램의 이름입니다.

     참고

     Search 서비스 애플리케이션이 일시 중지되는 동안 SharePoint Server 2019 또는 SharePoint Server 2016 환경의 인덱스는 업데이트되지 않습니다. 즉, SharePoint Server 구독 버전으로 업그레이드하는 동안 검색 결과가 덜 최신일 수 있습니다.

   • 검색 관리 데이터베이스를 읽기 전용으로 설정합니다. SharePoint Server 2019 또는 SharePoint Server 2016 데이터 및 사이트를 SharePoint Server 구독 버전으로 업그레이드하는 프로세스의 두 번째 단계에서는 다른 모든 데이터베이스를 읽기 전용으로 설정합니다. 검색 관리 데이터베이스에 대해 같은 지침을 따르세요.

   • SharePoint Server 2019 또는 SharePoint Server 2016 팜의 검색 관리 데이터베이스를 SharePoint Server 구독 버전 팜에 복사하고 검색 관리 데이터베이스에 대해서만 SharePoint Server 구독 버전으로 업그레이드하기 위해 데이터베이스를 새 팜으로 복사 의 절차를 따릅니다.

     중요

     SharePoint Server 구독 버전 환경에서 다음 단계를 수행합니다.

2. 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

   관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 구독 버전 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

   참고

   권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

3. SharePoint 구독 버전 관리 셸을 시작합니다.

4. 이 서비스 애플리케이션의 변수로 사용하려는 애플리케이션 풀을 저장하려면 PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

   $applicationPool = Get-SPServiceApplicationPool -Identity 'SharePoint Web Services default'
   

   여기서,

   SharePoint Web Services default는 새 서비스 응용 프로그램을 포함할 서비스 응용 프로그램 풀의 이름입니다.

   이 cmdlet은 서비스 응용 프로그램 풀을 이후에 사용하는 cmdlet에서 다시 사용할 수 있는 변수로 설정합니다. 응용 프로그램 풀이 여러 개 있는데 특정 서비스 응용 프로그램에 대해 다른 응용 프로그램 풀을 사용하려는 경우에는 절차에서 이 단계를 반복하여 적절한 응용 프로그램을 사용할 수 있도록 각 서비스 응용 프로그램을 만듭니다.

5. Search 서비스 애플리케이션을 복원하고 검색 관리 데이터베이스를 업그레이드하려면 PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

   $searchInst = Get-SPEnterpriseSearchServiceInstance -local
   # Gets the Search service instance and sets a variable to use in the next command
   Restore-SPEnterpriseSearchServiceApplication -Name '<SearchServiceApplicationName>' -applicationpool $applicationPool -databasename '<SearchServiceApplicationDBName>' -databaseserver <ServerName> -AdminSearchServiceInstance $searchInst 
   

   여기서,

   • SearchServiceApplicationName은 Search Service 응용 프로그램의 이름입니다.

   • $applicationpool은 사용할 서비스 응용 프로그램 풀을 식별하기 위해 설정한 변수입니다.

     참고

     $applicationPool 변수를 사용하지 않을 경우에는 ' Application Pool Name' 형식으로 기존 서비스 응용 프로그램 풀의 이름을 지정해야 합니다. 서비스 응용 프로그램 풀 목록을 보려면 Get-SPServiceApplicationPool cmdlet을 실행하면 됩니다.

   • SearchServiceApplicationDBName은 업그레이드할 검색 관리 데이터베이스의 이름으로, Search Service 응용 프로그램에서 사용됩니다.

   • $searchInst는 새 Search Service 응용 프로그램 인스턴스를 식별하기 위해 설정한 변수입니다.

     참고

     예를 들어 네트워크 또는 SQL Server 대기 시간으로 인해 Search 서비스 애플리케이션 업그레이드가 실패할 수 있습니다. 업그레이드 동안 오류 메시지가 나타나면 다음을 수행합니다.

     • 업그레이드하려 했던 검색 관리 데이터베이스를 삭제합니다.

     • 미리 만들어 둔 검색 관리 데이터베이스의 백업 복사본을 사용하여 Search Service 응용 프로그램에 대해서만 이 문서의 다음 절차를 반복합니다.

       • 데이터베이스의 백업 복사본 복원
       • 데이터베이스를 읽기/쓰기로 설정

     • PowerShell 명령 프롬프트에서 Search 서비스 애플리케이션을 다시 업그레이드하려면 명령을 입력합니다.

   자세한 내용은 Restore-SPEnterpriseSearchServiceApplication을 참조하세요.

6. Search 서비스 애플리케이션 프록시를 만들고 다음 작업을 완료하여 기본 프록시 그룹에 추가합니다.

   • 다음 명령을 입력하여 Search Service 응용 프로그램의 ID를 가져와 변수로 저장합니다.

     $ssa = Get-SPEnterpriseSearchServiceApplication
     

     자세한 내용은 Get-SPEnterpriseSearchServiceApplication을 참조하세요.

   • 다음 명령을 입력하여 Search Service 응용 프로그램의 프록시를 만듭니다.

     New-SPEnterpriseSearchServiceApplicationProxy -Name ProxyName -SearchApplication $ssa 
     

     여기서 각 부분이 나타내는 의미는 다음과 같습니다.

     • ProxyName은 사용할 프록시 이름입니다.

     • $ssa는 새 Search Service 응용 프로그램을 식별하기 위해 이전에 설정한 변수입니다.

       팁

       $ssa 변수를 사용하지 않는 경우에는 이름 대신 ID를 사용하여 Search Service 응용 프로그램을 식별해야 합니다. ID를 찾으려면 Get-SPServiceApplication cmdlet을 실행하여 모든 서비스 응용 프로그램 ID 목록을 반환하면 됩니다.

     자세한 내용은 New-SPEnterpriseSearchServiceApplicationProxy를 참조하세요.

   • 다음 명령을 입력하여 방금 만든 프록시의 Search Service 응용 프로그램 프록시 ID를 가져온 다음 $ssap 변수로 설정합니다.

     $ssap = Get-SPEnterpriseSearchServiceApplicationProxy 
     

     자세한 내용은 Get-SPEnterpriseSearchServiceApplicationProxy를 참조하세요.

   • 다음 명령을 입력하여 Search Service 응용 프로그램 프록시를 기본 프록시 그룹에 추가합니다.

     Add-SPServiceApplicationProxyGroupMember -member $ssap -identity ""
     

     여기서 각 부분이 나타내는 의미는 다음과 같습니다.

     • $ssap는 Search Service 응용 프로그램에 대해 방금 만든 프록시의 ID를 식별하기 위해 이전에 설정한 변수입니다.

       팁

       $ssap 변수를 사용하지 않는 경우에는 이름 대신 ID를 사용하여 Search Service 응용 프로그램을 식별해야 합니다. ID를 찾으려면 Get-SPServiceApplicationProxy cmdlet을 실행하여 모든 서비스 응용 프로그램 프록시 ID 목록을 반환하면 됩니다.

     • 빈 Identity 매개 변수("")를 사용하여 기본 그룹에 추가합니다.

     자세한 내용은 Add-SPServiceApplicationProxyGroupMember를 참조하십시오.

7. SharePoint Server 2019 또는 SharePoint Server 2016 팜에서 분할된 링크 데이터베이스를 사용하는 경우 SharePoint Server 구독 버전 팜에서 링크 데이터베이스를 동일한 방식으로 분할합니다. Move-SPEnterpriseSearchLinksDatabases에서 방법을 알아보세요

8. (선택 사항) SharePoint Server 2019 또는 SharePoint Server 2016 팜에서 검색 관련성 설정을 유지합니다. 업그레이드된 Search 서비스 애플리케이션에 빈 새 인덱스가 있으므로 SharePoint Server 2019 또는 SharePoint Server 2016 팜의 검색 분석 데이터를 완전히 보존할 수 없습니다. SharePoint Server 2019 또는 SharePoint Server 2016 팜에서 Analytics Reporting 데이터베이스를 복사하여 SharePoint Server 구독 버전 팜의 새 Search 서비스 애플리케이션에 연결합니다.

   • SharePoint Server 2019 또는 SharePoint Server 2016 팜에서 Analytics Reporting 데이터베이스를 백업 합니다.

   • SharePoint Server Subscription Edition 팜에서 백업된 데이터베이스를 새 데이터베이스 서버로 복원합니다.

   • SharePoint Server 구독 버전 팜에서 복원된 데이터베이스를 새 Search 서비스 애플리케이션에 연결합니다.

9. 새 SharePoint Server 구독 버전 팜의 검색 토폴로지가 SharePoint Server 2019 또는 SharePoint Server 2016 팜과 같은지 확인합니다. 검색 요구 사항이 변경된 경우 이제 새 SharePoint Server 구독 버전 팜의 검색 토폴로지를 스케일 아웃하는 것이 좋습니다.

10. SharePoint Server 환경에서 Search 서비스 애플리케이션을 다시 시작합니다.

    PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

    $ssa = Get-SPEnterpriseSearchServiceApplication <SearchServiceApplicationName>
    $ssa.ForceResume(0x02)
    

    여기서 각 부분이 나타내는 의미는 다음과 같습니다.

    • SearchServiceApplicationName은 재개하려는 Search Service 응용 프로그램의 이름입니다.

모든 새 프록시가 기본 프록시 그룹에 포함되어 있는지 확인

다음 절차에 따라 프록시를 만들어 기본 프록시 그룹에 추가하는 단계가 정상적으로 수행되었는지 확인합니다.

PowerShell을 사용하여 모든 새 프록시가 기본 프록시 그룹에 포함되어 있는지 확인하려면

1. 다음 멤버 자격이 있는지 확인합니다.

   • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

   • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

   • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

   관리자는 Add-SPShellAdmin cmdlet을 사용하여 SharePoint Server 2019 또는 SharePoint Server 2016 cmdlet을 사용할 수 있는 권한을 부여할 수 있습니다.

   참고

   권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

2. SharePoint 구독 버전 관리 셸을 시작합니다.

3. PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

   $pg = Get-SPServiceApplicationProxyGroup -Identity ""
   $pg.Proxies
   

   여기서 각 부분이 나타내는 의미는 다음과 같습니다.

   • $pg는 기본 프록시 그룹을 나타내기 위해 설정한 변수입니다.

   • 빈 ID 매개 변수("")를 사용하여 기본 프록시 그룹을 지정합니다.

   그러면 기본 프록시 그룹의 모든 프록시, 해당 표시 이름, 형식 이름 및 ID의 목록이 반환됩니다.

   자세한 내용은 Get-SPServiceApplicationProxyGroupGet-SPServiceApplicationProxyGroup을 참조하세요.

서비스 응용 프로그램이 업그레이드되었으므로 콘텐츠 데이터베이스 업그레이드 프로세스를 시작할 수 있습니다. 이 프로세스의 첫 단계에서는 각 콘텐츠 데이터베이스에 필요한 웹 응용 프로그램을 만듭니다.

단계	설명
	SharePoint Server 2019 및 SharePoint Server 2016 데이터 및 사이트를 SharePoint Server 구독 버전으로 업그레이드하는 프로세스의 세 번째 단계입니다. 전체 프로세스에 대한 개요는 SharePoint Server 구독 버전으로 업그레이드 프로세스 개요를 참조하세요.

다음 단계: 콘텐츠 데이터베이스를 SharePoint Server 구독 버전으로 업그레이드

참고 항목

개념

데이터베이스 연결 업그레이드를 위한 SharePoint Server 구독 버전 팜 만들기

SharePoint Server 구독 버전으로 업그레이드하기 위해 새 팜에 데이터베이스 복사

SharePoint Server로 콘텐츠 데이터베이스 업그레이드

SharePoint Server 구독 버전에 대한 서비스 업그레이드 개요