Condividi tramite


New-SPWebApplicationExtension

Crea una nuova istanza di area per l'applicazione Web.

Sintassi

New-SPWebApplicationExtension
   [-Identity] <SPWebApplicationPipeBind>
   -Name <String>
   -Zone <SPUrlZone>
   [-Port <UInt32>]
   [-HostHeader <String>]
   [-Certificate <SPServerCertificatePipeBind>]
   [-UseServerNameIndication]
   [-AllowLegacyEncryption]
   [-Path <String>]
   [-Url <String>]
   [-AuthenticationMethod <String>]
   [-AllowAnonymousAccess]
   [-SecureSocketsLayer]
   [-AuthenticationProvider <SPAuthenticationProviderPipeBind[]>]
   [-AdditionalClaimProvider <SPClaimProviderPipeBind[]>]
   [-SignInRedirectURL <String>]
   [-SignInRedirectProvider <SPTrustedIdentityTokenIssuerPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il New-SPWebApplicationExtension cmdlet crea una nuova istanza di zona per l'applicazione Web. Questa operazione è nota anche come estensione di un'applicazione Web e consente la configurazione di autorizzazioni alternative per lo stesso contenuto disponibile nell'applicazione Web esistente.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO-----------------------

Get-SPWebApplication http://sitename | New-SPWebApplicationExtension -Name "ExtranetSite" -SecureSocketsLayer -Zone "Extranet" -URL "https://extranet.sitename.com"

Questo esempio estende l'applicazione Web specificata in http://sitename all'area Extranet per l'uso SSL.

Parametri

-AdditionalClaimProvider

Aggiunge un provider di attestazioni specifico all'applicazione Web definita.

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

-AllowAnonymousAccess

Consente l'accesso anonimo all'area dell'applicazione Web.

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

-AllowLegacyEncryption

Specifica che le versioni precedenti del protocollo SSL e TLS e i pacchetti di crittografia possono essere usati con questo sito Web IIS. La crittografia legacy è più debole della crittografia moderna e non è consigliata.

Questa funzionalità richiede Windows Server 2022 o versione successiva. Questa funzionalità non è disponibile quando SharePoint viene distribuito con versioni precedenti di Windows Server.

Questo parametro è valido solo se usato con il parametro SecureSocketsLayer.

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

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

-AuthenticationMethod

Utilizza Kerberos o NTLM per specificare il metodo di autenticazione.

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

-AuthenticationProvider

Specifica uno o più provider di autenticazione applicabili a un'applicazione Web.

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

-Certificate

Specifica il certificato che verrà usato per l'associazione SSL (Secure Sockets Layer) di questo sito Web IIS. Questo parametro è valido solo se usato con il parametro SecureSocketsLayer.

Type:SPServerCertificatePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

-HostHeader

Specifica l'associazione dell'intestazione host per questo sito Web IIS. Un'associazione di intestazione host consente a più siti Web IIS di condividere lo stesso numero di porta. Le richieste Web inviate a un numero di porta condivisa vengono indirizzate al sito Web IIS corretto in base al valore dell'intestazione host HTTP inviata dal client.

Se non viene specificata alcuna associazione di intestazione host, tutte le richieste Web inviate a questo numero di porta verranno instradate al sito Web IIS, a meno che un altro sito Web IIS non disponga di un'associazione di intestazione host corrispondente all'intestazione host HTTP inviata dal client.

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

-Identity

Specifica l'applicazione Web da estendere.

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

-Name

Specifica il nome del nuovo sito Web IIS nell'applicazione Web.

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

-Path

Specifica la directory fisica per il nuovo sito Web (nella cartella directory virtuali). Il tipo è un percorso valido nel formato C:\Inetpub\wwwroot\ApplicazioneWeb.

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

-Port

Specifica la porta dell'applicazione. Può essere qualsiasi numero di porta valido.

Se non si specifica alcuna porta, verrà generato automaticamente un numero di porta non in conflitto.

Se si specifica un numero di porta già assegnato, IIS non avvia il nuovo sito fino a quando non si modifica il numero di porta del nuovo sito o quello del sito precedente.

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

-SecureSocketsLayer

Abilita la crittografia SSL (Secure Sockets Layer) per l'applicazione Web. Se si sceglie di usare SSL, è necessario importare un certificato server in SharePoint e assegnarlo al sito Web IIS per questa applicazione Web. Fino a questo punto, l'applicazione Web non sarà accessibile da questo sito Web IIS.

Il valore predefinito è False.

Se questo parametro viene omesso o impostato su False, questa applicazione Web userà HTTP per la porta specificata.

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

-SignInRedirectProvider

Imposta l'URL di reindirizzamento pagina di accesso in modo che punti all'URL definito nel provider di autenticazione specificato.

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

-SignInRedirectURL

Specifica l'URL di reindirizzamento pagina di accesso per l'applicazione Web.

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

-Url

Specifica l'URL con bilanciamento del carico per l'area dell'applicazione Web.

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

-UseServerNameIndication

Specifica che l'associazione SSL (Secure Sockets Layer) di questo sito Web IIS deve usare l'indicazione del nome del server (SNI). Indicazione nome server consente a più siti Web IIS con intestazioni host univoche e certificati server univoci di condividere la stessa porta SSL. Se l'indicazione del nome del server non viene usata, tutti i siti Web IIS che condividono la stessa porta SSL devono condividere lo stesso certificato server.

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

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

Specifica una delle cinque aree a cui deve essere associato l'URL interno della nuova estensione. Questa zona non può essere già in uso.

Il tipo deve essere uno dei valori seguenti: Default, Intranet, Internet, Extranet o Custom

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