Start-SPAssignment
Inicia um repositório de atribuições.
Syntax
Start-SPAssignment
[-AssignmentCollection <SPAssignmentCollection>]
[-Global]
[<CommonParameters>]
Description
O Start-SPAssignment
cmdlet descarta corretamente objetos usados com atribuições variáveis.
Grandes quantidades de memória são frequentemente exigidas quando os objetos SPWeb, SPSite ou SPSiteAdminsitration são usados. Portanto, o uso destes objetos ou listas destes objetos nos scripts do Windows PowerShell exige um gerenciamento de memória adequado. Por padrão, todos os comandos Get descartam estes objetos imediatamente após o pipeline ser finalizado, mas usando o SPAssignment é possível atribuir a lista de objetos para uma variável e descartar os objetos após não serem mais necessários. Também é possível garantir que os objetos permaneçam enquanto você precisar deles, mesmo através de várias iterações de comandos.
Há três níveis de atribuições:
-- Nenhuma atribuição -- O objeto não é atribuído a uma variável e é descartado após cada iteração do comando.
-- Atribuição simples -- Todos os objetos são atribuídos ao repositório de atribuições global. Isso é feito com o uso do parâmetro Global. Ao usar esse nível, todos os objetos serão atribuídos a um repositório global e serão descartados quando o cmdlet Stop-SPAssignment for chamado.
-- Atribuição avançada -- os objetos são atribuídos a repositórios nomeados para descarte. Você pode descartar objetos usando o parâmetro Identity com o Stop-SPAssignment
cmdlet.
Independentemente do nível de atribuição usado, todos os objetos são descartados quando o Windows PowerShell espaço de execução é fechado.
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-----------------------
Start-SPAssignment -global
$w = Get-SPWeb https://MyWeb
$w | Set-SPWeb -title "Accounting"
Stop-SPAssignment -global
Este exemplo usa atribuição simples.
Ainda que seja mais fácil usar a atribuição simples, a execução de comandos que realizam iterações por vários objetos SPSite ou SPWeb quando a atribuição simples estiver habilitada não é recomendada.
Verifique se você executa Stop-SPAssignment
antes de tentar qualquer iteração de vários objetos.
------------------EXEMPLO 2-----------------------
$gc = Start-SPAssignment
$web = $gc | Get-SPWeb https://MyWeb
$web | Set-SPWeb -title "Accounting"
Stop-SPAssignment -SemiGlobal $gc
Este exemplo define o título do objeto SPWeb em várias linhas e controla a taxa de descarte. Esse é um exemplo avançado. Apenas os desenvolvedores são aconselhados a usá-lo.
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.
Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment
, pode ocorrer um cenário de memória insuficiente.
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 |
-Global
Se você usar esse parâmetro, todos os objetos serão atribuídos ao tempo de vida do script e serão descartados quando o Stop-SPAssignment
cmdlet for chamado.
Se você não usar esse parâmetro, deverá atribuir a saída desse cmdlet a uma variável e, em seguida, descartar objetos usando o parâmetro Identity do Stop-SPAssignment
cmdlet.
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 |