Compartilhar via

Get-SPSiteAdministration

Módulo:
SharePointServer module

Retorna um objeto de administração de site que permite que os administradores do farm visualizem determinadas informações sobre os conjuntos de sites às quais eles podem não ter acesso.

Sintaxe

AllSitesInIdentity 

Get-SPSiteAdministration
    [-Identity] <SPSiteAdministrationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-Regex]
    [-WhatIf]
    [<CommonParameters>]

AllSitesInContentDB 

Get-SPSiteAdministration
    -ContentDatabase <SPContentDatabasePipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-WhatIf]
    [<CommonParameters>]

AllSitesInSiteSubscription 

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

AllSitesInWebApplication 

Get-SPSiteAdministration
    [-AssignmentCollection <SPAssignmentCollection>]
    [-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-SPSiteAdminitration devolve um objeto de administração de sites que permite aos administradores do farm ver determinadas informações sobre coleções de sites às quais poderão não ter acesso.

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-SPSiteAdministration | Select -Property Url, OwnerLoginName, @{Name="Storage";Expression={$_.Quota.StorageMaximumLevel}}

Este exemplo obtém um subconjunto de dados de todos os sites no banco de dados de conteúdo com a b399a366-d899-4cff-8a9b-8c0594ee755f (o administrador do farm não exige acesso). Este comando utiliza a propriedade calculada Armazenamento para apresentar o valor máximo de armazenamento para a base de dados de conteúdos.

EXEMPLO 2

Start-SPAssignment -Global
$s = Get-SPSiteAdministration -Identity https://MyApp/Sites/Site1
$s.Url
Stop-SPAssignment -Global

Este exemplo obtém as coleções de sites especificadas pelo parâmetro Identidade e insere os resultados na variável s. Este exemplo usa o método Global de coleta de lixo. Esse método é mais fácil de usar, mas aumenta rapidamente. Não execute um comando Get-SPSite que devolva muitos resultados enquanto a atribuição global estiver ativada.

EXEMPLO 3

C:\PS>$GC = Start-SPAssignment
$Sites = $GC | Get-SPSiteAdministration -Filter {$_.Owner -eq "DOMAIN\JDoe"} -Limit 50
Stop-SPAssignment $GC

Este exemplo obtém os 50 primeiros sites pertencentes ao usuário DOMAIN\JDoe usando uma consulta do lado do servidor e atribui os sites retornados a uma variável local. Este comando utiliza métodos de coleção de atribuições avançados.

EXEMPLO 4

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.DiskUsed }{$sum}

Este comando devolve a soma da utilização do espaço em disco para todos os sites na aplicação Web especificada.

EXEMPLO 5

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit ALL | Select URL

Este exemplo obtém os URLs de todas as coleções de sites numa aplicação Web.

EXEMPLO 6

Get-SPSiteAdministration -identity "https://localserver/(my|personal)/sites" -Regex

Este exemplo retorna todos os sites que correspondem à expressão regular determinada. As aspas em torno do valor especificado para o parâmetro Identity são necessárias ao utilizar o sinalizador Regex.

EXEMPLO 7

Get-SPSite "https://sitename/sites/teams/*" -Limit 100

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

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

-Confirm

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

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-ContentDatabase

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

Especifica a URL (completa ou parcial) ou o GUID do conjunto de sites a ser recuperado.

O tipo deve ser uma URL válida, no formato https://server_name; ou um GUID, no formato 1234-456-987fg.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Filter

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

Especifica o bloco de scripts do filtro do servidor a ser aplicado.

O tipo tem de ser um nome de filtro válido e um valor no formulário { $_ PropertyName <operador > "filterValue"}}

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
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 (completa ou parcial) ou o GUID do conjunto de sites a ser recuperado.

O tipo deve ser uma URL válida, no formato https://server_name; ou um GUID, no formato 1234-456-987fg.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Limit

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

Limita o número máximo de conjuntos de sites a serem retornados. O valor padrão é 200.

O tipo deve ser um número não negativo válido. Especifique ALL para retornar todos os conjuntos de sites referentes ao escopo determinado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-Regex

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

A habilitação desta opção faz com que a URL fornecida para o parâmetro Identity seja tratada como uma expressão regular.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-SiteSubscription

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

Especifica o grupo de sites de onde obter os conjuntos de sites.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um SPSite (objeto ou URL) de um conjunto de sites que é um membro da assinatura do site; ou uma instância de um objeto SiteSubscription válido.

Propriedades do parâmetro

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

Conjuntos de parâmetros

AllSitesInSiteSubscription
Cargo:Named
Obrigatório:True
Valor do pipeline:True
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, o GUID ou o nome do aplicativo Web a partir do qual listar sites.

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-WhatIf

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

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
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.