Compartilhar via


Get-SPManagedPath

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

Sintaxe

HostHeader

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

WebApplication

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 devolve o caminho gerido do SharePoint que corresponde à Identidade fornecida para uma aplicação Web, coleção de sites ou para todas as coleções de sites com nome de anfitrião. Se um parâmetro Identity não for fornecido, todos os caminhos gerenciados para o escopo determinado serão retornados.

Os sites com nome de anfitrião (independentemente da aplicação Web na qual estão contidos) partilham um único conjunto de caminhos geridos. Utilize o parâmetro HostHeader para devolver caminhos geridos com âmbito de coleções de sites com nome de anfitrião.

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 gerido dos Sites a partir dos caminhos geridos com âmbito de coleções de sites com nome de anfitrião.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-HostHeader

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Se for fornecido, os caminhos geridos devolvidos destinam-se aos sites com nome de anfitrião no farm.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

HostHeader
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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).

Propriedades do parâmetro

Tipo:SPPrefixPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WebApplication

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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).

Propriedades do parâmetro

Tipo:SPWebApplicationPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

WebApplication
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.