Start-SPAssignment

Inizia un nuovo archivio di assegnazioni.

Sintassi

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

Descrizione

Il Start-SPAssignment cmdlet elimina correttamente gli oggetti usati con le assegnazioni di variabili.

Per l'utilizzo degli oggetti SPWeb, SPSite o SPSiteAdminsitration sono spesso necessarie grandi quantità di memoria. Pertanto, l'uso di questi oggetti, o elenchi di questi oggetti, negli script Windows PowerShell richiede una gestione corretta della memoria. Per impostazione predefinita, tutti i comandi Get eliminano questi oggetti subito dopo la fine della pipeline, ma è possibile utilizzare SPAssignment per assegnare l'elenco di oggetti a una variabile ed eliminare gli oggetti quando non sono più necessari. È inoltre possibile assicurarsi che gli oggetti rimangano a disposizione fino a quando sono necessari, anche per più iterazioni dei comandi.

Esistono tre livelli di assegnazione:

-- Nessuna assegnazione : l'oggetto non viene assegnato a una variabile e viene eliminato dopo ogni iterazione del comando.

-- Assegnazione semplice: tutti gli oggetti vengono assegnati all'archivio assegnazioni globale. Questa operazione viene eseguita usando il parametro Global. Quando si usa questo livello, tutti gli oggetti vengono assegnati a un archivio globale e vengono eliminati quando viene chiamato il cmdlet Stop-SPAssignment.

-- Assegnazione avanzata : gli oggetti vengono assegnati agli archivi denominati per l'eliminazione. È possibile eliminare gli oggetti usando il parametro Identity con il Stop-SPAssignment cmdlet .

Indipendentemente dal livello di assegnazione usato, tutti gli oggetti vengono eliminati quando lo spazio di esecuzione Windows PowerShell viene chiuso.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO 1-----------------------

Start-SPAssignment -global
$w = Get-SPWeb https://MyWeb
$w | Set-SPWeb -title "Accounting"
Stop-SPAssignment -global

In questo esempio viene utilizzata l'assegnazione semplice. Sebbene sia più facile da utilizzare, non è consigliabile eseguire comandi in modo iterativo su più oggetti SPSite o SPWeb quando è abilitata l'assegnazione semplice. Assicurarsi di eseguire Stop-SPAssignment prima di tentare qualsiasi iterazioni di più oggetti.

------------------ESEMPIO 2-----------------------

$gc = Start-SPAssignment
$web = $gc | Get-SPWeb https://MyWeb
$web | Set-SPWeb -title "Accounting"
Stop-SPAssignment -SemiGlobal $gc

This example sets the title of the SPWeb object in multiple lines and controls the rate of disposal. This is an advanced example. Only developers are advised to use it.

Parametri

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Globale

Se si usa questo parametro, tutti gli oggetti vengono assegnati alla durata dello script e vengono eliminati quando viene chiamato il Stop-SPAssignment cmdlet.

Se non si usa questo parametro, è necessario assegnare l'output di questo cmdlet a una variabile e quindi eliminare gli oggetti usando il parametro Identity del Stop-SPAssignment cmdlet.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition