Share via

Invoke-SPOSiteSwap

  • 참조
모듈:
Microsoft.Online.SharePoint.PowerShell
적용 대상:
SharePoint Online

원본 사이트를 보관할 때 사이트 위치를 다른 사이트와 전환하는 작업을 호출합니다.

Syntax

Invoke-SPOSiteSwap
         -SourceUrl <string>
         -TargetUrl <string>
         -ArchiveUrl <string>
         [-DisableRedirection]
         [-Force]
         [-NoWait]   
      [<CommonParameters>]

Description

원본 대상 사이트를 보관하는 동안 원본 사이트의 위치를 대상 사이트와 전환합니다.

대상 사이트는 다음 중 하나이어야 합니다.

전환이 시작되면 대상 사이트는 보관 위치로 이동되고 원본 사이트는 대상 위치로 이동됩니다. 기본적으로 사이트 리디렉션은 대상 위치로 트래픽을 리디렉션하는 원본 위치에서 만들어집니다.

대상이 https://tenant-name.sharepoint.com에서의 루트 사이트인 경우 전환이 수행되기 전에 다음의 준비 활동을 수행해야 합니다.

  1. https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx의 SharePoint 시작 페이지에서 정의된 모든 주요 링크는 전환을 수행한 후 표시되지 않습니다. 필요한 경우 전환 후 수동으로 다시 만들 수 있도록 주요 링크를 문서화해야 합니다.
  2. 외부 공유 및 응용 프로그램 인터페이스와 같은 기능은 루트 사이트에서 정의된 정책 및 사용 권한에 따라 달라집니다. 원본 사이트를 검토하여 기존 루트 사이트에 대 한 필수 정책과 권한을 보유하고 있는지 확인합니다. 여기에는 외부 공유 설정 뿐 아니라 사이트 권한도 포함됩니다.
  3. 라이선스가 10,000개 이상인 대규모 테넌트는 원본 사이트에 대해 페이지 진단 도구를 실행해야 합니다(페이지 진단 도구를 실행하는 사용자에게 원본 사이트에서 편집 권한이 있는지 확인). 주의 필요(빨간색) 또는 개선 기회(주황색) 범주가 있는 모든 분석 결과는 전환 수행 전에 교정해야 합니다.

원본 및 대상 사이트는 Office 365 그룹에 연결할 수 없습니다. 또한 허브 사이트가 되거나 허브와 연결할 수 없습니다. 사이트가 허브 사이트인 경우 허브 사이트로 등록을 해제하고 루트 사이트를 전환 후 사이트를 허브 사이트로 등록합니다. 사이트가 허브와 연결된 경우에는 사이트의 연결을 해제하고, 루트 사이트를 전환 후 사이트를 다시 연결합니다.

게시 기능이 이전에 활성화되었거나 현재 원본 사이트에서 활성화된 경우 Invoke-SPOSiteSwap를 사용할 수 없습니다.

예제

예제 1

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

https://contoso.sharepoint.com의 기존 사이트를 https://contoso.sharepoint.com/sites/Archive(으)로 아카이브하고 https://contoso.sharepoint.com/sites/CommunicationSite를 https://contoso.sharepoint.com.(으)로 이동합니다. 모든 요청을 https://contoso.sharepoint.com.(으)로 리디렉션하는 사이트 리디렉션이 https://contoso.sharepoint.com/sites/CommunicationSite에 생성됩니다.

예제 2

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive

https://contoso.sharepoint.com/search의 기존 검색 센터 사이트를 https://contoso.sharepoint.com/sites/Archive(으)로 아카이브하고 https://contoso.sharepoint.com/sites/SearchSite를 https://contoso.sharepoint.com/search.(으)로 이동합니다. 모든 요청을 https://contoso.sharepoint.com/search.(으)로 리디렉션하는 사이트 리디렉션이 https://contoso.sharepoint.com/sites/SearchSite에 생성됩니다.

예제 3

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/CommunicationSite -TargetUrl https://contoso.sharepoint.com -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -DisableRedirection

기존 사이트를 https://contoso.sharepoint.com에서 https://contoso.sharepoint.com/sites/Archive(으)로 아카이브하고 https://contoso.sharepoint.com/sites/CommunicationSite를 https://contoso.sharepoint.com.(으)로 이동합니다. https://contoso.sharepoint.com/sites/CommunicationSite.에 사이트 리디렉션이 생성되지 않습니다

예제 4

Invoke-SPOSiteSwap -SourceUrl https://contoso.sharepoint.com/sites/SearchSite -TargetUrl https://contoso.sharepoint.com/search -ArchiveUrl https://contoso.sharepoint.com/sites/Archive -Force

https://contoso.sharepoint.com/search의 기존 검색 센터 사이트를 https://contoso.sharepoint.com/sites/Archive(으)로 아카이브하고 https://contoso.sharepoint.com/sites/SearchSite를 https://contoso.sharepoint.com/search.(으)로 이동합니다. 모든 요청을 https://contoso.sharepoint.com/search.(으)로 리디렉션하는 사이트 리디렉션이 https://contoso.sharepoint.com/sites/SearchSite에 생성됩니다. 페이지 진단 도구로 식별된 모든 경고는 무시되며 전환이 시작됩니다. 하지만 페이지 진단 도구로 식별된 모든 오류는 여전히 전환을 시작하지 못하도록 합니다.

매개 변수

-ArchiveUrl

대상 사이트가 보관될 URL입니다. 전환 작업을 수행하기 전에 휴지통에 삭제된 사이트를 포함하여 기존의 사이트가 없어야 합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DisableRedirection

원본 URL 위치에서 사이트 리디렉션이 만들어지지 않도록 설정합니다.

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Force

전환을 시작하지 못하도록 하는 페이지 진단 도구로 식별된 모든 경고를 재정의하고 무시합니다.

예를 들어 "Invoke-SPOSiteSwap: 오류: 0; 경고: 1; 세부 정보: 2개 항목이 CDN에 없습니다. CDN을 사용하도록 설정하세요." 이 매개 변수를 사용하여 경고를 재정의할 수 있지만 장기적인 안정성 및 성능을 위해 항목을 검토하고 해결해야 합니다.

페이지 진단 도구로 식별된 모든 오류는 해당 매개변수와 상관 없이 항상 전환을 시작하지 못하도록 할 수 있습니다.

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-NoWait

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:Switch Parameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-SourceUrl

원본 사이트의 URL입니다. 이 위치의 사이트는 전환을 수행하기 전에 존재 해야 합니다.

대상이 https://tenant-name.sharepoint.com에서의 루트 사이트인 경우 원본 사이트는 최신 팀 사이트(STS#3) 또는 통신 사이트(SITEPAGEPUBLISHING # 0)여야 하며, 게시 기능은 원본 사이트에서 활성화되었을 수 없습니다.

대상이 https://tenant-name.sharepoint.com/search에서의 검색 센터 사이트인 경우 원본 사이트는 검색 센터 사이트(SRCHCEN # 0) 또는 기본 검색 센터 사이트(SRCHCENTERLITE # 0) 이어야 합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-TargetUrl

원본 사이트를 전환할 대상 사이트의 URL입니다. 이 위치의 사이트는 전환을 수행하기 전에 존재 해야 합니다.

대상 사이트는 다음 중 하나이어야 합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online