Condividi tramite


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

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

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition