Invoke-SPOSiteSwap
Appelle un travail pour permuter l’emplacement d’un site avec un autre site lors de l’archivage du site d’origine.
Syntaxe
Default (Par défaut)
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 :
- Le site racine, par exemple
https://tenant-name.sharepoint.com; soit - Le site du Centre de recherche, par exemple
https://tenant-name.sharepoint.com/search.
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 :
- Les liens proposés définis dans la page d’accueil de SharePoint sur
https://tenant-name.sharepoint.com/_layouts/15/sharepoint.aspxne 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. - 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.
- 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
Applicable : SharePoint Online
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.
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisableRedirection
Applicable : SharePoint Online
Désactive la création de la redirection de site à partir de l’emplacement de l’URL source.
Propriétés du paramètre
| Type: | Switch Parameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Applicable : SharePoint Online
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.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-NoWait
Applicable : SharePoint Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | System.Management.Automation.SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SourceUrl
Applicable : SharePoint Online
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).
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TargetUrl
Applicable : SharePoint Online
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 :
- Le site racine sur
https://tenant-name.sharepoint.comou - Le site du Centre de recherche sur
https://tenant-name.sharepoint.com/search
Propriétés du paramètre
| Type: | System.String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.