Start-SPAssignment

Start-SPAssignment
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Global]
    [<CommonParameters>]

O Start-SPAssignment cmdlet elimina corretamente os objetos utilizados com atribuições de 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:

-- Sem atribuição - O objeto não está atribuído a uma variável e é eliminado após cada iteração do comando.

-- Atribuição simples – todos os objetos são atribuídos ao arquivo 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 arquivos nomeados para eliminação. Pode eliminar objetos com o parâmetro Identidade com o Stop-SPAssignment cmdlet .

Independentemente do nível de atribuição utilizado, todos os objetos são eliminados 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.

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. Certifique-se de que executa Stop-SPAssignment antes de tentar iterações de múltiplos objetos.

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

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.