Set-SPAlternateURL

  • Référence
Module:
sharepoint-server
S’applique à:
SharePoint Server Subscription Edition

Configure l'URL de substitution spécifiée.

Syntax

Set-SPAlternateURL
   [-Identity] <SPAlternateUrlPipeBind>
   [-Url <String>]
   [-Zone <SPUrlZone>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

L’applet Set-SPAlternateUrl de commande modifie l’URL ou la zone de l’AUTRE URL spécifiée par le paramètre Identity. Cette applet de commande peut être utilisée pour modifier uniquement la zone des URL internes et ne peut pas être utilisée pour modifier la zone des URL publiques.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

------------------EXEMPLE 1------------------

Set-SPAlternateURL -Identity https://www.contoso.com -Zone "Internet"

Cet exemple montre comment modifier la zone de l’AUTRE URL https://www.contoso.com.

------------------EXEMPLE 2------------------

Set-SPAlternateURL -Identity https://www.contoso.com -Url https://sharepoint.contoso.com -Zone "Default"

Cet exemple montre comment modifier l’URL et la zone de l’AUTRE URL https://www.contoso.com.

------------------EXEMPLE 3------------------

Get-SPAlternateURL https://www.contoso.com | Set-SPAlternateURL -Zone "Internet"

Cet exemple montre comment modifier la zone de l’AUTRE URL https://www.contoso.com.

------------------EXEMPLE 4------------------

Get-SPWebApplication |%{ Get-SPAlternateURL -WebApplication $_ -Zone "Extranet" } | Set-SPAlternateURL -Zone "Intranet"

Cet exemple change la zone de l’autre URL pour l’application web spécifiée de Extranet en Intranet.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : 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 Subscription Edition

-Identity

Spécifie l'URL ou le GUID de l'URL de substitution à modifier.

Le type doit être une URL valide au format https://server_name/WebApplication/site, ou un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh.

Type:SPAlternateUrlPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Url

Spécifie la nouvelle URL de substitution.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : 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 Subscription Edition

-Zone

Définit l'URL de substitution fournie comme l'une des cinq zones.

Le type doit être l'une des valeurs suivantes : Default, Intranet, Internet, Extranet ou Custom.

Type:SPUrlZone
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition