Get-SPAlternateURL

适用于: SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题: 2015-03-09

返回符合给定条件集的所有备用 URL。

Syntax

Get-SPAlternateURL [[-Identity] <SPAlternateUrlPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Zone <Default | Intranet | Internet | Custom | Extranet>]

Get-SPAlternateURL [[-Identity] <SPAlternateUrlPipeBind>] -WebApplication <SPWebApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Zone <Default | Intranet | Internet | Custom | Extranet>]

Get-SPAlternateURL [[-Identity] <SPAlternateUrlPipeBind>] -ResourceName <String> [-AssignmentCollection <SPAssignmentCollection>] [-Zone <Default | Intranet | Internet | Custom | Extranet>]

详细说明

Get-SPAlternateURL cmdlet 加入到某个参数集中。Get-SPAlternateURL cmdlet 将返回与给定范围(由可选的 Identity 参数给定,或者由可选的 WebApplicationZoneResource 参数的组合给定)匹配的所有备用 URL。添加的每一项条件都将缩小范围。如果未指定任何条件,那么返回所有备用 URL。

如果使用了 Identity 参数,那么只返回匹配该标识的特定备用 URL。如果给定范围内不存在带有给定标识的备用 URL,那么不返回任何内容。

Parameters

参数 是否必需 类型 说明

Identity

可选

Microsoft.SharePoint.PowerShell.SPAlternateUrlPipeBind

指定要获取的备用 URL 的 URL 或 GUID。

类型必须是有效的 GUID,格式为 12345678-90ab-cdef-1234-567890bcdefgh;或者有效的 URL,格式为 http://server_name。

ResourceName

必需

System.String

指定资源的名称,将从该资源中列出备用 URL。

WebApplication

必需

Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind

指定 Web 应用程序,将从该 Web 应用程序中列出备用 URL。

AssignmentCollection

可选

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

管理对象以便正确进行处理。使用 SPWebSPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWebSPSiteSPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

注意Note
在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

Zone

可选

System.String

指定五个区域中与备用 URL 关联的区域。

必须是有效区域:DefaultIntranetInternetExtranetCustom

输入类型

返回类型

Example

--------------示例 1-----------------

Get-SPAlternateURL -WebApplication http://sitename

此示例将显示给定 Web 应用程序的所有备用 URL。

--------------示例 2-----------------

Get-SPAlternateURL -ResourceName "MyResource"

此示例将显示给定资源的所有备用 URL。

See Also

Reference

New-SPAlternateUrl
Set-SPAlternateUrl
Remove-SPAlternateUrl