Crea un nuovo servizio Windows.
Sintassi
New-Service [-Name] <string> [-BinaryPathName] <string> [-Credential <PSCredential>] [-DependsOn <string[]>] [-Description <string>] [-DisplayName <string>] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Mediante il cmdlet New-Service viene creata una nuova voce per un servizio di Windows nel Registro di sistema e nel database del servizio. Per un nuovo servizio è necessario un file eseguibile da eseguire durante il servizio.
I parametri del cmdlet consentono di impostare il nome visualizzato, la descrizione, il tipo di avvio e le dipendenze del servizio.
Parametri
-BinaryPathName <string>
Specifica il percorso del file eseguibile per il servizio. Questo parametro è obbligatorio.
|
Obbligatorio? |
true |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Credential <PSCredential>
Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01". In alternativa, immettere un oggetto PSCredential, ad esempio uno del cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-DependsOn <string[]>
Specifica i nomi di altri servizi dai quali dipende il nuovo servizio. Per immettere più nomi di servizio, separarli con una virgola.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Description <string>
Specifica una descrizione del servizio.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-DisplayName <string>
Specifica un nome visualizzato per il servizio.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Name <string>
Specifica il nome del servizio. Questo parametro è obbligatorio.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-StartupType <ServiceStartMode>
Imposta il tipo di avvio del servizio. "Automatic" è il valore predefinito.
I valori validi sono:
--Manual: il servizio viene avviato solo manualmente, da un utente (mediante Gestione controllo servizi) o da un'applicazione.
-- Automatic: il servizio deve essere avviato, o è stato avviato, dal sistema operativo all'avvio del sistema. Se un servizio avviato automaticamente dipende da un servizio avviato manualmente, anche quest'ultimo viene avviato automaticamente all'avvio del sistema.
-- Disabled: il servizio è disabilitato e non può essere avviato da un utente o un'applicazione.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
Automatic |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Nessuno Non è possibile reindirizzare l'input a questo cmdlet. |
|
Output |
System.ServiceProcess.ServiceController New-Service restituisce un oggetto che rappresenta il nuovo servizio. |
Note
Per eseguire questo cmdlet in Windows Vista e nelle versioni successive di Windows, avviare Windows PowerShell con l'opzione "Esegui come amministratore".
Esempio 1
C:\PS>new-service -name TestService -binaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs" Descrizione ----------- Con questo comando viene creato un nuovo servizio denominato "TestService".
Esempio 2
C:\PS>new-service -name TestService -path "C:\WINDOWS\System32\svchost.exe -k netsvcs" -dependson NetLogon -displayName "Test Service" -StartupType Manual -Description "This is a test service." Descrizione ----------- Con questo comando viene creato un nuovo servizio denominato "TestService". Vengono utilizzati i parametri del cmdlet New-Service per specificare una descrizione, un tipo di avvio e un nome visualizzato per il nuovo servizio. Per specificare il parametro BinaryPathName, viene utilizzato l'alias del parametro Path. È anche possibile utilizzare "-bpn".
Esempio 3
C:\PS>get-wmiobject win32_service -filter "name='testservice'" ExitCode : 0 Name : testservice ProcessId : 0 StartMode : Auto State : Stopped Status : OK Descrizione ----------- Viene utilizzato il cmdlet Get-WmiObject per ottenere l'oggetto Win32_Service per il nuovo servizio. Questo oggetto include la modalità di avvio e la descrizione del servizio.
Vedere anche