Start-SPAssignment
Inizia un nuovo archivio di assegnazioni.
Sintassi
Default (impostazione predefinita).
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
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | SPAssignmentCollection |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Global
Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.