Condividi tramite

Enable-PSSessionConfiguration

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Abilita le configurazioni di sessione nel computer locale.

Sintassi

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il cmdlet Enable-PSSessionConfiguration abilita le configurazioni di sessione registrate che sono state disabilitate, ad esempio usando i cmdlet Disable-PSSessionConfiguration o Disable-PSRemoting oppure il parametro accessMode di Register-PSSessionConfiguration. Si tratta di un cmdlet avanzato progettato per essere usato dagli amministratori di sistema per gestire configurazioni di sessione personalizzate per gli utenti.

Senza parametri, Enable-PSSessionConfiguration abilita la configurazione di Microsoft.PowerShell, ovvero la configurazione predefinita usata per le sessioni.

Enable-PSSessionConfiguration rimuove l'impostazione Deny_All dal descrittore di sicurezza delle configurazioni di sessione interessate, attiva il listener che accetta le richieste su qualsiasi indirizzo IP e riavvia il servizio WinRM. A partire da PowerShell 3.0, Enable-PSSessionConfiguration imposta anche il valore della proprietà Enabled della configurazione della sessione (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) su True. Tuttavia, Enable-PSSessionConfiguration non rimuove o modifica l'impostazione del descrittore di sicurezza Network_Deny_All (AccessMode=Local) che consente solo agli utenti del computer locale di usare per la configurazione della sessione.

Esempio

Esempio 1: Riabilitare la sessione predefinita

In questo esempio viene riattivata la Microsoft.PowerShell configurazione di sessione predefinita nel computer.

Enable-PSSessionConfiguration

Esempio 2: Riabilitare le sessioni specificate

Questo esempio abilita nuovamente le configurazioni di sessione MaintenanceShell e AdminShell nel computer.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Esempio 3: Riabilitare tutte le sessioni

In questo esempio vengono riattivate tutte le configurazioni di sessione nel computer. Questi comandi sono equivalenti. Pertanto, è possibile usare uno dei due.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration non genera un errore se si abilita una configurazione di sessione già abilitata.

Esempio 4: Riabilitare una sessione e specificare un nuovo descrittore di sicurezza

In questo esempio viene riattivata la configurazione di MaintenanceShell sessione e viene specificato un nuovo descrittore di sicurezza per la configurazione.

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che il cmdlet non richiede conferma e riavvia il servizio WinRM senza chiedere conferma. Il riavvio del servizio rende effettiva la modifica della configurazione.

Per evitare un riavvio e eliminare il prompt di riavvio, usare il parametro NoServiceRestart.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica i nomi delle configurazioni di sessione da abilitare. Immettere uno o più nomi di configurazione. Sono consentiti caratteri jolly.

È anche possibile inviare tramite pipe una stringa contenente un nome di configurazione o un oggetto di configurazione della sessione a Enable-PSSessionConfiguration.

Se si omette questo parametro, Enable-PSSessionConfiguration abilita la configurazione della sessione Microsoft.PowerShell.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-NoServiceRestart

Indica che il cmdlet non riavvia il servizio.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SecurityDescriptorSddl

Specifica un descrittore di sicurezza con cui questo cmdlet sostituisce il descrittore di sicurezza nella configurazione della sessione.

Se si omette questo parametro, Enable-PSSessionConfiguration elimina solo l'elemento deny all dal descrittore di sicurezza.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipNetworkProfileCheck

Indica che questo cmdlet abilita la configurazione della sessione quando il computer si trova in una rete pubblica. Questo parametro abilita una regola del firewall per le reti pubbliche che consente l'accesso remoto solo dai computer nella stessa subnet locale. Per impostazione predefinita, Enable-PSSessionConfiguration ha esito negativo in una rete pubblica.

Questo parametro è progettato per le versioni client del sistema operativo Windows. Le versioni server del sistema operativo Windows hanno una regola del firewall subnet locale per le reti pubbliche. Tuttavia, se la regola del firewall della subnet locale è disabilitata in una versione del server del sistema operativo Windows, questo parametro lo abilita nuovamente.

Per rimuovere la restrizione della subnet locale e abilitare l'accesso remoto da tutte le posizioni nelle reti pubbliche, usare il cmdlet Set-NetFirewallRule nel modulo NetSecurity. Per altre informazioni, vedere Enable-PSRemoting.

Questo parametro è stato introdotto in PowerShell 3.0.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

È possibile inviare tramite pipe un oggetto di configurazione sessione a questo cmdlet.

String

È possibile inviare tramite pipe una stringa contenente il nome di una configurazione di sessione a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.

Per usare questo cmdlet, è necessario avviare PowerShell usando l'opzione Esegui come amministratore.