Start-SPAssignment

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

Questo esempio utilizza 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

Questo esempio imposta il titolo dell'oggetto SPWeb in più righe e controlla la frequenza di eliminazione. Questo è un esempio avanzato. È consigliabile usarlo solo per gli sviluppatori.

Parametri

-AssignmentCollection

-Global