Get-SPSiteAdministration

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Syntax

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

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

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

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 retorna um objeto de administração de site que permite que os administradores do farm exibam determinadas informações sobre coleções de sites às quais talvez não tenham 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). Esse comando usa a propriedade calculada Armazenamento para exibir o valor máximo de armazenamento para o banco de dados de conteúdo.

------------------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 site especificadas pelo parâmetro Identity 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 retorna muitos resultados enquanto a atribuição global está ativada.

------------------EXAMPLE 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 usa métodos avançados de coleção de atribuições.

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

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

Esse comando retorna a soma do uso de espaço em disco para todos os sites no aplicativo Web especificado.

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

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

Este exemplo obtém as URLs para todas as coleções de sites em um aplicativo Web.

------------------EXAMPLE 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 usar o sinalizador Regex.

------------------EXAMPLE 7------------------

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

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

Parâmetros

-AssignmentCollection

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.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ContentDatabase

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.

Type:	SPContentDatabasePipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Filter

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

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

Type:	ScriptBlock
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

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.

Type:	SPSiteAdministrationPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Limit

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Regex

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteSubscription

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.

Type:	SPSiteSubscriptionPipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

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

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Compartilhar via