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

Il Enable-PSSessionConfiguration cmdlet abilita le configurazioni di sessione registrate che sono state disabilitate, ad esempio usando i Disable-PSSessionConfiguration cmdlet o Disable-PSRemoting o il parametro AccessMode di Register-PSSessionConfiguration. Si tratta di un cmdlet avanzato progettato per essere usato dagli amministratori di sistema per gestire le configurazioni di sessione personalizzate per i propri 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 () suWSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled 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 configurazione di sessione predefinita di Microsoft.PowerShell nel computer.

Enable-PSSessionConfiguration

Esempio 2: Riabilitare le sessioni specificate

In questo esempio vengono riattivate le configurazioni della 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

Questo esempio abilita nuovamente la configurazione della sessione maintenanceShell e specifica 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. Al riavvio del servizio viene applicata la modifica alla configurazione.

Per impedire 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 configurazioni. I caratteri jolly sono consentiti.

È 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 di 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 da computer nella stessa subnet locale. Per impostazione predefinita, Enable-PSSessionConfiguration non riesce 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 Set-NetFirewallRule cmdlet nel modulo NetSecurity. Per ulteriori 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 gli effetti dell'esecuzione del cmdlet. 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 output.

Note

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