Get-SPSite

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>]

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.

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

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.

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.

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

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.

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.

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

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

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.

Get-SPSite -Limit all -CompatibilityLevel 14

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

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.