Condividi tramite

Enable-PSSessionConfiguration

Modulo:
Microsoft.PowerShell.Core Module

Abilita le configurazioni di sessione nel computer locale.

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-NoServiceRestart

Indica che il cmdlet non riavvia il servizio.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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

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