Get-SPSite

Syntax

Get-SPSite
   [-Identity] <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [-NeedsB2BUpgrade]
   [<CommonParameters>]

Get-SPSite
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [-WhatIf]
   [<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-SPSite retorna um único site que corresponde ao parâmetro Identity ou todos os sites que correspondem ao parâmetro Filter para o escopo especificado. Os escopos são os parâmetros WebApplication, ContentDatabase e SiteSubscription. Caso nenhum desses escopos seja fornecido, o escopo será o farm. Se o escopo for especificado sem o parâmetro Filter, todos os sites desse escopo serão retornados.

O parâmetro Identity também oferece suporte para fornecer uma URL parcial que termina em um caractere curinga (*). Todos os conjuntos de sites que correspondem a essa URL parcial para o escopo especificado são retornados. Além disso, se o parâmetro Regex for fornecido, o parâmetro Identity será tratado como uma expressão regular e qualquer conjunto de sites com uma URL fornecida no escopo determinado que corresponda à expressão será retornado.

O parâmetro Filter é um filtro do servidor para determinadas propriedades do conjunto de sites armazenadas no banco de dados de conteúdo; sem o parâmetro Filter, a filtragem dessas propriedades é um processo lento. Essas propriedades do conjunto de sites são Owner, SecondaryOwner e LockState. O parâmetro Filter é um bloco de script que usa a mesma sintaxe da declaração Where-Object, mas é executada no servidor para obter resultados mais rápidos.

Os valores válidos para LockState são: Unlock, NoAdditions, ReadOnly, NoAccess.

É importante observar que cada conjunto de sites retornado pelo cmdlet Get-SPSite é destruído automaticamente no fim do pipeline. Para armazenar os resultados de Get-SPSite em uma variável local, os cmdlets Start-SPAssignment e Stop-SPAssignment devem ser usados para evitar perdas de memória.

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-SPSite 'https://<site name>' | Get-SPWeb -Limit All | Select Title

Este exemplo obtém a coleção de títulos de subweb na coleção de sites em https://< nome> do local.

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

Get-SPSite -ContentDatabase "b399a366-d899-4cff-8a9b-8c0594ee755f" | Format-Table -Property Url, Owner, SecondaryOwner

Este exemplo obtém um subconjunto de dados de todos os sites do banco de dados de conteúdo b399a366-d899-4cff-8a9b-8c0594ee755f.

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

Start-SPAssignment -Global

$s = Get-SPSite -Identity https://<MyApp>/Sites/Site1

$s.Url

Stop-SPAssignment -Global

Este exemplo obtém os sites especificados pelo parâmetro Identity e insere os resultados na variável s.

O exemplo anterior usa o método Global do conjunto de atribuições. O método Global é mais fácil de usar, mas os conteúdos desse objeto crescem muito rapidamente. Tenha cuidado para não executar um comando Get-SPSite que retorna muitos resultados quando a atribuição global está habilitada.

------------------EXEMPLO 4---------------------

$GC = Start-SPAssignment
$Sites = $GC | Get-SPSite -Filter {$_.Owner -eq "DOMAIN\JDow"} -Limit 50
Stop-SPAssignment $GC

Este exemplo obtém os 50 primeiros sites pertencentes ao usuário DOMAIN\JDow usando uma consulta do servidor e os atribui a uma variável local.

Este exemplo usa métodos avançados do conjunto de atribuições.

------------------EXEMPLO 5---------------------

Get-SPWebApplication https://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

Este exemplo mostra um comando que retorna a soma do uso de espaço em disco para todos os sites de um determinado aplicativo Web.

------------------EXEMPLO 6---------------------

Get-SPSite -Identity "https://localserver/(my|personal)/sites" -Regex

Este exemplo retorna todos os sites que correspondem à expressão regular determinada.

As Cotas do parâmetro Identity serão obrigatórias quando o parâmetro Regex for usado.

------------------EXEMPLO 7---------------------

Get-SPSite https://<site name>/sites/teams/* -Limit 100

Este exemplo obtém até 100 dos sites na URL https://sitename/sites/teams.

------------------EXEMPLO 8---------------------

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

Este exemplo obtém a quantidade de armazenamento usada por um conjunto de sites, usando o campo de armazenamento da propriedade .UsageInfo.

------------------EXAMPLE 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

Este exemplo retorna todas as coleções de sites de modo do SharePoint Server.

Parâmetros

-AssignmentCollection

-CompatibilityLevel

-Confirm

-ContentDatabase

-Filter

-Identity

-Limit

-NeedsB2BUpgrade

-Regex

-SiteSubscription

-WebApplication

-WhatIf