다음을 통해 공유


Upgrade-SPSite

사이트 모음에 대한 업그레이드 프로세스를 시작합니다.

Syntax

Upgrade-SPSite
       [-Identity] <SPSitePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Email]
       [-QueueOnly]
       [-Unthrottled]
       [-VersionUpgrade]
       [-WhatIf]
       [-Priority <Byte>]
       [<CommonParameters>]

Description

cmdlet은 Upgrade-SPSite 사이트 모음에서 업그레이드 프로세스를 시작합니다.

cmdlet은 Upgrade-SPSite 지정된 SPSite 개체에 대한 업그레이드 프로세스를 활성화합니다. 이 cmdlet을 사용하여 실패한 업그레이드를 다시 시작할 수도 있습니다. 이 cmdlet을 통해 SPSite 개체에 대한 업그레이드를 시작하는 경우 해당 개체는 빌드 간 또는 버전 간 업그레이드일 수 있습니다.

기본적으로 cmdlet은 Upgrade-SPSite 빌드-빌드 업그레이드로 작동합니다. 따라서 패치 작업 후 이 cmdlet을 사용하는 경우 예기치 않은 사이트 모음 버전 업그레이드를 방지할 수 있습니다. 버전 간 업그레이드 모드에서는 사이트 모음 상태 검사가 복구 모드로 실행되어 사이트 모음이 업그레이드 가능한 정상 상태인지를 확인합니다. 이 검사가 성공하면 나머지 업그레이드 과정이 수행됩니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

---------------예제 1---------------

Upgrade-SPSite https://<site name>/sites/testsite

다음은 현재 사이트 모음 운영 모드와 연결된 사용 가능한 빌드 간 업그레이드 작업만 사용하여 기존 https://< 사이트 이름>/사이트/testsite 사이트 모음을 업그레이드하는 예제입니다. 이 작업을 수행해도 SPSite.CompatibilityLevel은 변경되지 않습니다.

---------------예제 2---------------

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

다음은 현재 사이트 모음 운영 모드와 연결되고 버전 간 업그레이드를 수행하는 사용 가능한 모든 빌드 간 업그레이드 작업을 사용하여 기존 https://< 사이트 이름>/사이트/testsite 사이트 모음을 업그레이드하는 예제입니다.

매개 변수

-AssignmentCollection

올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.

Global 매개 변수가 사용되는 경우 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to: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 2013, SharePoint Server 2016, SharePoint Server 2019

-Email

사이트 모음 업그레이드 완료 시 메일을 보낼지 여부를 지정합니다.

Type:SwitchParameter
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

-Identity

업그레이드 작업을 다시 실행할 SPSite 개체를 지정합니다.

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

-Priority

업그레이드할 사이트의 우선 순위를 지정합니다.

유효한 값은 다음과 같습니다.

  • 128-255(낮은 우선 순위)

  • 11-127(보통 우선 순위)

  • 0-10(높은 우선 순위)

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

-QueueOnly

타이머 작업으로 관리되는 지연된 업그레이드를 위해 사이트를 큐에 넣도록 지정합니다.

Type:SwitchParameter
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

-Unthrottled

팜 관리자가 제한을 우회하도록 지정합니다. 그러면 제한이 적용되는 업그레이드할 사이트 모음이 너무 많아도 사이트 모음을 업그레이드할 수 있습니다.

Type:SwitchParameter
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

-VersionUpgrade

SPSite 개체에 대한 버전 간 업그레이드를 수행하도록 지정합니다. 이 매개 변수를 설정하면 현재 사이트 모음 작동 모드와 연결된 사용 가능한 모든 빌드 간 작업이 내부적으로 트리거됩니다. 그런 다음 버전 간 작업이 수행되어 사이트 모음이 다음 사이트 모음 작동 모드로 설정되며, 여기에는 새 사이트 모음 작동 모드와 연결된 모든 새 빌드 간 작업이 포함됩니다. 이 매개 변수를 설정하지 않으면 현재 사이트 모음 작동 모드와 연결된 사용 가능한 빌드 간 업그레이드 작업만 트리거됩니다.

Type:SwitchParameter
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

-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 2013, SharePoint Server 2016, SharePoint Server 2019