Get-SPAlternateURL

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Restituisce tutti gli URL alternativi corrispondenti al set di criteri specificato.

Sintassi

Get-SPAlternateURL
   [[-Identity] <SPAlternateUrlPipeBind>]
   -ResourceName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]
Get-SPAlternateURL
   [[-Identity] <SPAlternateUrlPipeBind>]
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Il cmdlet Get-SPAlternateURL restituisce tutti gli URL alternativi corrispondenti all'ambito specificato tramite il parametro facoltativo Identity o tramite una combinazione dei parametri facoltativi WebApplication, Zone o Resource. Ogni criterio aggiunto restringe l'ambito. Se non si specifica alcun criterio, verranno restituiti tutti gli URL alternativi.

Se si utilizza il parametro Identity, verrà restituito solo l'URL alternativo corrispondente specificato. Se non esiste alcun URL alternativo con l'identità specificata nell'ambito specificato, non verrà prodotto alcun output.

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 1-----------------

Get-SPAlternateURL -WebApplication https://sitename

Questo esempio consente di visualizzare tutti gli URL alternativi in un'applicazione Web specificata.

--------------ESEMPIO 2-----------------

Get-SPAlternateURL -ResourceName "MyResource"

Questo esempio consente di visualizzare tutti gli URL alternativi per una risorsa specificata.

Parametri

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica l'URL o il GUID dell'URL alternativo da recuperare.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh o un URL valido nel formato https://server_name.

Type:SPAlternateUrlPipeBind
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ResourceName

Specifica il nome della risorsa da cui elencare gli URL alternativi.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

Specifica l'applicazione Web da cui elencare gli URL alternativi.

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Zone

Specifica una delle cinque aree a cui sono associati gli URL alternativi.

Deve essere un'area valida, ovvero uno dei valori seguenti: Default, Intranet, Internet, Extranet o Custom.

Type:SPUrlZone
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019