Invoke-SPOSiteSwap

  • Référence
Module:
Microsoft.Online.SharePoint.PowerShell
S’applique à:
SharePoint Online

Appelle un travail pour permuter l’emplacement d’un site avec un autre site lors de l’archivage du site d’origine.

Syntax

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

Description

Permute l’emplacement d’un site source avec un site cible lors de l’archivage du site cible d’origine.

Veuillez noter que le site cible doit être soit :

Une fois la permutation initiée, le site cible est déplacé vers l’emplacement d’archivage et le site source est déplacé vers l’emplacement cible. Par défaut, une redirection de site est créée à l’emplacement source qui redirige le trafic vers l’emplacement cible.

Si la cible est le site racine sur https://tenant-name.sharepoint.com, vous devez effectuer les activités de préparation suivantes avant d’effectuer la permutation :

  1. Les liens proposés définis dans la page d’accueil de SharePoint sur https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspx ne s’afficheront pas après la permutation. Si nécessaire, les liens proposés doivent être documentés afin de pouvoir être recréés manuellement après la permutation.
  2. Les fonctionnalités telles que le partage externe et les interfaces d’applications dépendent des stratégies et des autorisations définies sur le site racine. Examinez le site source pour vous assurer qu’il dispose des stratégies et des autorisations requises, conformément au site racine existant. Cela inclut les paramètres de partage externe ainsi que les autorisations de site.
  3. Les locataires plus volumineux qui ont plus de 10 000 licences doivent exécuter l’outil de diagnostic de page sur le site source (vérifiez que l’utilisateur exécutant l’outil de diagnostic de page dispose de droits de modification sur le site source). Les résultats d’analyse dont la catégorie Attention requise (en rouge) ou Opportunités d’amélioration (en orange) doit être rectifiée avant d’effectuer le basculement.

Les sites sources et cibles ne peuvent pas être connectés à un groupe Office 365. Ils ne peuvent pas non plus être des sites hub ou associés à un hub. Si un site est un site hub, désinscrivez-le comme étant un site hub, remplacez le site racine, puis inscrivez le site en tant que site hub. Si un site est associé à un hub, dissociez le site, remplacez le site racine, puis associez le site de nouveau.

Si la fonctionnalité de publication a déjà été activée ou l’est actuellement sur le site source, vous ne pouvez pas utiliser Invoke-SPOSiteSwap.

Exemples

EXEMPLE 1

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

Archive le site existant sur https://contoso.sharepoint.com vers https://contoso.sharepoint.com/sites/Archive et déplace https://contoso.sharepoint.com/sites/CommunicationSite vers https://contoso.sharepoint.com.. Une redirection de site sera créée sur https://contoso.sharepoint.com/sites/CommunicationSite qui redirigera toutes les requêtes vers https://contoso.sharepoint.com.

EXEMPLE 2

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

Archive le site du Centre de recherche existant sur https://contoso.sharepoint.com/search vers https://contoso.sharepoint.com/sites/Archive et déplace https://contoso.sharepoint.com/sites/SearchSite vers https://contoso.sharepoint.com/search.. Une redirection de site sera créée sur https://contoso.sharepoint.com/sites/SearchSite qui redirigera toutes les requêtes vers https://contoso.sharepoint.com/search.

EXEMPLE 3

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

Archive le site existant sur https://contoso.sharepoint.com vers https://contoso.sharepoint.com/sites/Archive et déplace https://contoso.sharepoint.com/sites/CommunicationSite vers https://contoso.sharepoint.com.. Aucune redirection de site ne sera créée sur https://contoso.sharepoint.com/sites/CommunicationSite.

EXEMPLE 4

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

Archive le site Centre de recherche existant sur https://contoso.sharepoint.com/search vers https://contoso.sharepoint.com/sites/Archive et déplace le https://contoso.sharepoint.com/sites/SearchSite vers https://contoso.sharepoint.com/search.. Une redirection de site sera créée sur https://contoso.sharepoint.com/sites/SearchSite qui redirige les demandes vers https://contoso.sharepoint.com/search.. Tous les avertissements identifiés par l’Outil de diagnostic de page seront ignorés, puis la permutation démarrera. Toutefois, les erreurs identifiées par l’Outil diagnostics de page empêchent de lancer la permutation.

Paramètres

-ArchiveUrl

URL vers laquelle le site cible sera archivé. Il ne doit pas y avoir de site existant (y compris un site supprimé présent dans la corbeille) à cet emplacement avant d’effectuer la permutation.

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

-DisableRedirection

Désactive la création de la redirection de site à partir de l’emplacement de l’URL source.

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

-Force

Neutralise et ignore les avertissements qui ont été identifiés par l’Outil de diagnostic de page qui empêchent le démarrage d’une permutation.

Par exemple, si vous recevez l’avertissement « Invoke-SPOSiteSwap : Errors: 0; Avertissements : 1 ; Détails : 2 éléments ne sont pas dans cdn, veuillez activer CDN. » Les avertissements peuvent être substitués à l’aide de ce paramètre, mais les éléments doivent être examinés et résolus pour la stabilité et les performances à long terme.

Toutefois, les erreurs identifiées par l’Outil diagnostics de page empêchent toujours de lancer une permutation, indépendamment de ce paramètre.

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

-NoWait

Ce paramètre est réservé à l’usage interne chez 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 du site source. Le site doit exister à cet emplacement avant d’effectuer la permutation.

Si la cible est le site racine sur https://tenant-name.sharepoint.com, le site source doit être un site d’équipe moderne (STS#3) ou un site de communication (SITEPAGEPUBLISHING#0). D’autre part, la fonctionnalité de publication doit toujours avoir été désactivée sur le site source.

Si la cible est le site Centre de recherche sur https://tenant-name.sharepoint.com/search, le site source doit être un site Centre de recherche (SRCHCEN#0) ou un site Centre de recherche de base (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 du site cible vers lequel le site source sera permuté. Le site doit exister à cet emplacement avant d’effectuer la permutation.

Le site cible doit être soit :

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