Start-SPAssignment

Módulo:

sharepoint-server

Aplica-se a:

SharePoint Server Subscription Edition

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 Subscription Edition

-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 Subscription Edition