Get-SPManagedPath

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

Retorna todos os caminhos gerenciados que correspondem aos critérios fornecidos.

Syntax

Get-SPManagedPath
   [[-Identity] <SPPrefixPipeBind>]
   [-HostHeader]
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

Get-SPManagedPath
   [[-Identity] <SPPrefixPipeBind>]
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]

Description

Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O cmdlet Get-SPManagedPath retorna o caminho gerenciado do SharePoint que corresponde à Identidade fornecida para um aplicativo Web, uma coleção de sites ou para todas as coleções de sites nomeadas pelo host. Se um parâmetro Identity não for fornecido, todos os caminhos gerenciados para o escopo determinado serão retornados.

Sites nomeados pelo host (não importa o aplicativo Web no qual estejam contidos) compartilham um único conjunto de caminhos gerenciados. Use o parâmetro HostHeader para retornar caminhos gerenciados com escopo de coleções de sites nomeados pelo host.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

--------------EXEMPLO 1-----------------

Get-SPManagedPath -WebApplication https://sitename

Este exemplo retorna todos os caminhos gerenciados para o aplicativo Web especificado.

--------------EXEMPLO 2-----------------

Get-SPManagedPath -identity "Sites" -HostHeader

Este exemplo obtém o caminho gerenciado pelos Sites dos caminhos gerenciados com escopo de coleções de sites nomeados pelo host.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

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

-HostHeader

Se fornecidos, os caminhos gerenciados retornados serão para os locais nomeados pelo host no farm.

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

-Identity

Especifica a URL ou o GUID do caminho gerenciado a ser retornado.

O tipo deve ser uma URL válida, no formato https://server_name ou um GUID válido (por exemplo, 12345678-90ab-cdef-1234-567890bcdefgh).

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

-WebApplication

Especifica a URL ou o GUID do aplicativo Web do qual obter o caminho gerenciado.