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 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

Questo esempio abilita nuovamente le configurazioni di sessione maintenanceShell e Amministrazione Shell 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

Indica che il cmdlet non riavvia il servizio.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Questo cmdlet è disponibile solo nelle piattaforme Windows.

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