Informazioni di riferimento sulla riga di comando per la Configurazione guidata Prodotti e tecnologie SharePoint (Office SharePoint Server)

In Prodotti e tecnologie SharePoint è possibile utilizzare lo strumento da riga di comando psconfig.exe come interfaccia alternativa per eseguire diverse operazioni di controllo della configurazione di Prodotti e tecnologie SharePoint. Per eseguire tali operazioni, è necessario essere membri del gruppo Administrators del computer locale.

Contenuto dell'articolo

  • Come utilizzare i comandi di psconfig.exe

  • Comandi e parametri disponibili

Come utilizzare i comandi di psconfig.exe

Quando si esegue psconfig.exe dalla riga di comando, è possibile specificare una serie di comandi per controllare il funzionamento dello strumento. Per eseguire psconfig.exe dalla riga di comando, passare alla cartella %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\12\bin e quindi digitare i comandi utilizzando la sintassi seguente:

Psconfig.exe -cmd <command> [optional parameters]

Nella tabella di riferimento contenuta nella sezione successiva sono disponibili numerosi esempi. È inoltre possibile accedere alla Guida dall'interfaccia della riga di comando. Per visualizzare la Guida, nella riga di comando digitare:

psconfig.exe -?

Per visualizzare le informazioni della Guida su un comando specifico, digitare:

psconfig.exe -help <command name>

I comandi disponibili in psconfig.exe devono essere eseguiti in un ordine specifico per funzionare correttamente. Se si utilizza Configurazione guidata Prodotti e tecnologie SharePoint per configurare l'installazione, la procedura esegue automaticamente una chiamata ai comandi (denominati anche attività di configurazione) nell'ordine corretto. Se invece si utilizza la riga di comando per eseguire psconfig.exe, è necessario accertarsi che le attività siano eseguite nell'ordine corretto. I comandi di psconfig.exe devono essere eseguiti nell'ordine seguente:

  1. configdb

  2. helpcollections

  3. secureresources

  4. services

  5. installfeatures

  6. adminvs

  7. evalprovision (solo per installazioni autonome)

  8. applicationcontent

  9. upgrade

Importante

Se la server farm necessita di un aggiornamento, all'esecuzione di psconfig.exe verrà avviato automaticamente un processo di aggiornamento, senza necessità di specificare il relativo comando.

È possibile specificare l'esecuzione di tutti i comandi in un'unica stringa della riga di comando. In tal modo, psconfig.exe eseguirà tutti i comandi nell'ordine corretto. Nella riga di comando è ad esempio possibile eseguire un comando simile al seguente:

psconfig.exe –cmd configdb <parameters>
–cmd helpcollections <parameters>
–cmd secureresources <parameters>
–cmd services <parameters>
–cmd installfeatures <parameters>
–cmd adminvs <parameters>
–cmd evalprovision <parameters>
–cmd applicationcontent <parameters>

Comandi e parametri disponibili

In Configurazione guidata Prodotti e tecnologie SharePoint vengono riconosciute le opzioni della riga di comando seguenti.

Comando Descrizione, parametri ed esempi

?

Visualizza i comandi che è possibile utilizzare con psconfig.exe.

Esempio

psconfig.exe -?

help <command name>

Visualizza i comandi che è possibile utilizzare con psconfig.exe. Se viene specificato un nome di comando, vengono visualizzati gli argomenti della Guida relativi a tale comando.

Esempio

psconfig.exe -help adminvs

adminvs

Gestisce l'applicazione Web Amministrazione centrale SharePoint nel computer locale. Accetta i parametri facoltativi seguenti:

[-provision]

Effettua il provisioning dell'applicazione Web Amministrazione centrale SharePoint nel server. Il provisioning crea una nuova applicazione Web Amministrazione centrale SharePoint e un pool di applicazioni eseguite tramite l'account dell'amministratore della server farm.

[-unprovision]

Annulla il provisioning dell'applicazione Web Amministrazione centrale SharePoint nel server. L'annullamento del provisioning rimuove l'applicazione Web Amministrazione centrale SharePoint e il relativo pool di applicazioni.

[-port <port number>]

La porta dell'applicazione Web Amministrazione centrale SharePoint è un'impostazione globale della server farm. Se si modifica il numero di porta, verrà avviato un processo del servizio Timer di SharePoint per sincronizzare il numero di porta di tutte le applicazioni Web Amministrazione centrale SharePoint disponibili nella server farm. Se non si specifica una porta, verrà utilizzata la porta impostata per le applicazioni Web Amministrazione centrale SharePoint esistenti nella server farm. Se non è stato effettuato il provisioning di un'applicazione Web Amministrazione centrale SharePoint nella server farm, la porta predefinita verrà scelta in modo casuale se non ne viene specificata una particolare.

[-windowsauthprovider <enablekerberos | onlyusentlm>]

Il provider di autenticazione dell'applicazione Web Amministrazione centrale SharePoint è un'impostazione globale della server farm. Se si modifica il provider di autenticazione, verrà avviato un processo del servizio Timer di SharePoint per sincronizzare il provider in tutte le applicazioni Web Amministrazione centrale SharePoint nella server farm. Se si specifica onlyusentlm, NTLM sarà il provider di autenticazione esclusivo per tutte le applicazioni Web Amministrazione centrale SharePoint. Tutti gli altri provider di autenticazione verranno disattivati e NTLM sarà l'unico provider di autenticazione consentito. Se si specifica enablekerberos, l'autenticazione Kerberos verrà attivata per tutte le applicazioni Web Amministrazione centrale SharePoint. Se non si specifica un provider di autenticazione, verrà utilizzato il provider impostato per le applicazioni Web Amministrazione centrale SharePoint esistenti nella server farm. Se non è stato effettuato il provisioning di un'applicazione Web Amministrazione centrale SharePoint nella server farm, verrà attivato il provider di autenticazione Kerberos se non è specificato un provider di autenticazione.

Esempi

psconfig.exe -cmd adminvs -provision -port 8080 -windowsauthprovider onlyusentlm

psconfig.exe -cmd adminvs -unprovision

applicationcontent

Gestisce il contenuto dell'applicazione condiviso. Accetta il parametro obbligatorio seguente:

-install

Copia i dati condivisi dell'applicazione (ad esempio file di risorse e file binari dell'applicazione Web) nelle directory virtuali esistenti dell'applicazione Web.

Esempio

psconfig.exe -cmd applicationcontent -install

configdb

Crea, connette o disconnette il server nella server farm. Accetta i parametri facoltativi seguenti:

[-create]

Crea un nuovo database di configurazione e pertanto crea una nuova server farm. Se il server è già connesso a un database di configurazione, tale server verrà innanzitutto disconnesso e quindi verrà creato il nuovo database di configurazione.

[-disconnect]

Disconnette il server dal database di configurazione e pertanto disconnette il server dalla server farm.

[-connect]

Effettua la connessione a un database di configurazione esistente e pertanto aggiunge il server a una server farm esistente. Se il server è già connesso a un database di configurazione, tale server verrà innanzitutto disconnesso e quindi connesso al database di configurazione esistente.

[-server <SQLServerName>]

Computer che esegue SQL Server in cui è archiviato il database di configurazione.

[-database <SQLDatabaseName>]

Nome del database di configurazione.

[-dbuser <value>]

Nome utente utilizzato per l'autenticazione di SQL Server.

[-dbpassword <value>]

Password utilizzata per l'autenticazione di SQL Server.

[-user <Domain\User>]

Account utente dell'amministratore della server farm.

[-password <Password>]

Password dell'account dell'amministratore della server farm.

[-addomain <value>]

Nome del dominio di Active Directory utilizzato per la server farm.

[-adorgunit <value>]

Nome dell'unità organizzativa di Active Directory utilizzata per la server farm.

[-admincontentdatabase <SQLAdminContentDatabaseName>]

Nome del database del contenuto dell'applicazione Web Amministrazione centrale.

Esempi

psconfig.exe -cmd configdb -create -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

-user <DOMAIN\username> -password <password>

-addomain <domain_name> -adorgunit <org_unit>

-admincontentdatabase <Database_name>

psconfig.exe -cmd configdb -disconnect

psconfig.exe -cmd configdb -connect -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

evalprovision

Effettua il provisioning del server come server autonomo (modalità di valutazione). Accetta i parametri obbligatori e facoltativi seguenti:

-provision

Esegue il provisioning in modalità autonoma nel server.

[-port <port number>]

Numero di porta assegnato all'applicazione Web di SharePoint predefinita. Se non specificato, verrà utilizzata la porta 80. Se esiste già un'applicazione Web di SharePoint che utilizza la porta specificata, il sito esistente verrà sovrascritto. Se la porta è utilizzata da un sito esistente non configurato come applicazione Web di SharePoint, il sito verrà disattivato e verrà creata una nuova applicazione Web di SharePoint associata alla porta specificata.

[-overwrite]

Specifica di sovrascrivere qualsiasi sito Web esistente di Microsoft Windows SharePoint Services 3.0 in fase di installazione. Se non specificato, il sito non verrà eliminato.

Esempio

psconfig.exe -cmd evalprovision -provision -port 1100

helpcollections

Gestisce gli insiemi di file della Guida. Accetta i parametri obbligatori seguenti:

-installall

Installa tutti gli insiemi di file della Guida disponibili.

Esempio

psconfig.exe -cmd helpcollections -installall

installfeatures

Registra qualsiasi caratteristica di Prodotti e tecnologie SharePoint memorizzata nel file system del server con la server farm.

Esempio

psconfig.exe -cmd installfeatures

quiet

Esegue la Configurazione guidata Prodotti e tecnologie in modalità non interattiva. L'output viene scritto nel file di registro PSCONFIG.EXE_GG_MM_AA_HH_MM_SS_MS.log, dove "_GG_MM_AA_HH_MM_SS_MS" indica la data e l'ora di esecuzione dell'utilità. Il file di registro è memorizzato nella directory %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\12\LOGS.

Esempio

psconfig.exe -cmd quiet

secureresources

Applica la protezione delle risorse di Prodotti e tecnologie SharePoint nel server. Ad esempio, la protezione viene applicata su file, cartelle e chiavi del Registro di sistema.

Esempio

psconfig.exe -cmd secureresources

services

Gestisce i servizi di Prodotti e tecnologie SharePoint. Accetta i parametri facoltativi seguenti:

[-install]

Registra i servizi della server farm installati nel server.

[-provision]

Effettua il provisioning dei servizi installati nel server e li imposta come in linea se Prodotti e tecnologie SharePoint sono installati in modalità autonoma. Il provisioning dei servizi assicura inoltre che siano registrati.

Esempio

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

Esegue la configurazione di Prodotti e tecnologie SharePoint in base alla modalità di installazione. Ripristina inoltre la configurazione. Se il prodotto o la tecnologia è installata in modalità autonoma, verrà eseguita la configurazione autonoma. Se il prodotto o la tecnologia non è in modalità autonoma, sarà necessario completare la configurazione iniziale utilizzando Configurazione guidata Prodotti e tecnologie SharePoint anziché l'utilità da riga di comando psconfig.exe. Per eseguire la procedura guidata fare clic sul pulsante Start, scegliere Tutti i programmi, Strumenti di amministrazione e infine fare clic su Configurazione guidata Prodotti e tecnologie SharePoint.

Se si desidera ripristinare un'installazione autonoma, eseguire innanzitutto l'installazione o il ripristino (per ulteriori informazioni, vedere la Guida del programma di installazione) e quindi il comando setup di psconfig.exe. Per le installazioni di server farm, dopo aver eseguito l'installazione o il ripristino, utilizzare la Configurazione guidata Prodotti e tecnologie SharePoint anziché l'utilità da riga di comando psconfig.exe.

Accetta il parametro facoltativo seguente:

[-lcid <1033>]

ID delle impostazioni internazionali (LCID) che specifica la lingua di installazione.

Esempio

psconfig.exe -cmd setup

standaloneconfig

Esegue una configurazione autonoma di Prodotti e tecnologie SharePoint. Accetta i parametri facoltativi seguenti:

[-lcid <1033>]

ID delle impostazioni internazionali (LCID) che specifica la lingua di installazione.

Esempio

psconfig.exe -cmd standaloneconfig

upgrade

Esegue un aggiornamento di Prodotti e tecnologie SharePoint. Questo comando viene eseguito automaticamente all'esecuzione della Configurazione guidata Prodotti e tecnologie SharePoint se il prodotto o la tecnologia necessita di un aggiornamento. Accetta i parametri facoltativi seguenti:

[-wait]

Se si specifica questo parametro, la Configurazione guidata Prodotti e tecnologie SharePoint restituisce il controllo solo dopo il completamento dell'aggiornamento. Se il parametro non viene specificato, la configurazione guidata restituisce il controllo dopo l'avvio di un processo del servizio Timer di SharePoint per l'esecuzione dell'aggiornamento. Per visualizzare lo stato del processo di aggiornamento, è possibile accedere all'applicazione Web Amministrazione centrale SharePoint dal Web browser.

[-force]

Se si specifica questo parametro, la Configurazione guidata Prodotti e tecnologie SharePoint interromperà le eventuali azioni di aggiornamento in esecuzione e riavvierà l'aggiornamento.

[-reghostonupgrade]

Se si specifica questo parametro, durante l'aggiornamento la Configurazione guidata Prodotti e tecnologie SharePoint reimposterà tutti i contenuti secondo la definizione del sito.

[-finalize]

Se si specifica questo parametro, la Configurazione guidata prodotti e tecnologie SharePoint completerà l'aggiornamento in esecuzione. Eseguire questa operazione solo al termine dell'aggiornamento di tutti i siti, quando non è più necessario mantenere il collegamento alla versione precedente. Questa operazione non potrà essere annullata.

[-inplace <v2v|b2b>]

Se si specifica questo parametro, la Configurazione guidata Prodotti e tecnologie SharePoint eseguirà un aggiornamento sul posto. Se si specifica v2v, verrà eseguito un aggiornamento sul posto da versione a versione. Se si specifica b2b, verrà eseguito un aggiornamento sul posto da build a build.

[-sidebyside]

Se si specifica questo parametro, la Configurazione guidata Prodotti e tecnologie SharePoint eseguirà un aggiornamento graduale.

Esempi

psconfig.exe -cmd upgrade -inplace v2v -wait
psconfig.exe -cmd upgrade -sidebyside -reghostonupgrade
psconfig.exe -cmd upgrade -finalize

Scaricare il manuale

Questo argomento è incluso nel manuale seguente che può essere scaricato per una lettura e una stampa più agevoli:

Vedere l'elenco completo delle pubblicazioni disponibili in Downloadable books for Office SharePoint Server 2007 (informazioni in lingua inglese).