Get-SPSiteAdministration
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 -GlobalEste 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 $GCEste 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 URLEste 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" -RegexEste 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 100Este 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 |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de