Get-SPWeb

Retorna todos os subsites que correspondem aos critérios fornecidos.

Syntax

Get-SPWeb
   [[-Identity] <SPWebPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-Site <SPSitePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

O cmdlet Get-SPWeb retorna todos os subsites que correspondem ao escopo fornecido pelo parâmetro Identity. Todos os subsites que atendem aos critérios são retornados.

The Identity can be either the full URL or a relative path. If you specify a relative path, you must also specify the Site parameter to identify the site collection from which to return the subsite.

The Identity parameter also supports providing a partial URL that ends in a wildcard character (*). All subsites that match this partial URL for the specified scope are returned. Additionally, if the Regex parameter is provided, the Identity parameter is treated as a regular expression and any subweb with a URL provided in the given scope that matches the expression is returned.

O parâmetro Filter é um filtro do lado do servidor para determinadas propriedades de subsite que são armazenadas no banco de dados de conteúdo; sem o parâmetro Filter, a filtragem nessas propriedades é um processo lento. Essas propriedades de subsite são Template e Title. O parâmetro Filter é um bloco de scripts que usa a mesma sintaxe que uma instrução Where-Object, mas é executada do lado do servidor para obter resultados mais rápidos.

It is important to note that every site collection returned by the Get-SPWeb cmdlet is automatically disposed of at the end of the pipeline. To store the results of Get-SPWeb in a local variable, the Start-SPAssignment and Stop-SPAssignment cmdlets must be used to avoid memory leaks.

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-SPWeb -site https://sitename/sites/site1

Este exemplo retorna todas as subwebs em um determinado conjunto de sites.

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

Get-SPWeb -Site https://sitename/sites/site1  -filter {$_.Template -eq "STS#0"}

Este exemplo exibe todos os subsites que usam o modelo "STS#0".

--------------------EXEMPLO 3----------------------

Start-SPAssignment -Global
$w = Get-SPWeb https://sitename
$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
$w.Update()
Stop-SPAssignment -Global

Este exemplo demonstra como salvar um subsite como uma variável e chamar métodos de modelo de objeto no objeto SPAssignment.

Parâmetros

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

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

-Filtrar

Especifica o filtro do lado do servidor a ser usado para o escopo especificado.

O tipo deve ser um filtro válido no formato {filterName <operator> "filterValue"}.

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

-Identidade

Especifica o nome ou a URL completa ou parcial do subsite. Se você usar um caminho relativo, especifique o parâmetro Site.

Uma URL válida no formato https://server_name ou um caminho relativo no formato /SubSites/MySubSite.

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

-Limite

Limita o número máximo de subsites a serem retornados. O valor padrão é 200. Para retornar todos os sites, insira ALL.

O tipo deve ser um número válido maior que 0 ou ALL.

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

-Regex

Especifica se a URL fornecida pelo parâmetro Identity deve ser tratada como uma expressão regular.

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

-Site

Especifica a URL ou o GUID do conjunto de sites a partir do qual listar subsites.

O tipo deve ser uma URL válida, https://server_namena forma de ; um GUID, no formato 1234-5678-9807, ou um objeto SPSite.

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

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

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