Condividi tramite

Set-PSSessionConfiguration

Modulo:
Microsoft.PowerShell.Core Module

Modifica le proprietà di una configurazione di sessione registrata.

Sintassi

NameParameterSet (Impostazione predefinita) 

Set-PSSessionConfiguration
    [-Name] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AssemblyNameParameterSet 

Set-PSSessionConfiguration
    [-Name] <String>
    [-AssemblyName] <String>
    [-ConfigurationTypeName] <String>
    [-ApplicationBase <String>]
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-PSVersion <Version>]
    [-SessionTypeOption <PSSessionTypeOption>]
    [-TransportOption <PSTransportOption>]
    [-ModulesToImport <Object[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SessionConfigurationFile 

Set-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-TransportOption <PSTransportOption>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il Set-PSSessionConfiguration cmdlet modifica le proprietà delle configurazioni di sessione nel computer locale.

Utilizzare il parametro Name per identificare la configurazione della sessione che si desidera modificare. Utilizzare gli altri parametri per specificare nuovi valori per le proprietà della configurazione della sessione. Per eliminare un valore della proprietà dalla configurazione e usare il valore predefinito, immettere una stringa vuota ("") o un valore per $null il parametro corrispondente.

A partire da PowerShell 3.0, è possibile usare un file di configurazione della sessione per definire una configurazione della sessione. Questa funzionalità fornisce un metodo semplice e individuabile per impostare e modificare le proprietà delle sessioni che utilizzano la configurazione di sessione. Per specificare un file di configurazione della sessione, utilizzare il parametro Path di Set-PSSessionConfiguration. Per informazioni sui file di configurazione della sessione, vedere about_Session_Configuration_Files. Per informazioni su come creare e modificare un file di configurazione della sessione, vedere il New-PSSessionConfigurationFile cmdlet.

Le configurazioni di sessione definiscono l'ambiente delle sessioni remote (PSSession) che si connettono al computer locale. Ogni sessione PSSession utilizza una configurazione di sessione. La configurazione della sessione determina le funzionalità di PSSession, ad esempio i moduli disponibili nella sessione, i cmdlet che possono essere eseguiti, la modalità lingua, le quote e i timeout. Il descrittore di sicurezza della configurazione della sessione determina chi può utilizzare la configurazione della sessione per connettersi al computer locale. Per altre informazioni sulle configurazioni di sessione, vedere about_Session_Configurations.

Per visualizzare le proprietà di una configurazione di sessione, utilizzare il Get-PSSessionConfiguration cmdlet o il provider WSMan. Per ulteriori informazioni sul provider WSMan, digitare Get-Help WSMan.

Esempio

Esempio 1: Modificare lo stato dell'apartment del thread

PS C:\> Set-PSSessionConfiguration -Name "MaintenanceShell" -ThreadApartmentState STA

Questo comando modifica lo stato dell'apartment del thread nella configurazione di MaintenanceShell in STA. La modifica è effettiva quando si riavvia il servizio Gestione remota Windows .

Esempio 2: Creare e modificare la configurazione di una sessione

In questo esempio viene illustrato come aggiungere e rimuovere uno script di avvio da una configurazione.

Il primo comando crea la configurazione di AdminShell . Il secondo comando aggiunge lo AdminConfig.ps1 script alla configurazione. La modifica è effettiva al riavvio di WinRM. Il terzo comando rimuove lo AdminConfig.ps1 script dalla configurazione.

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $null

Esempio 3: Visualizzazione dei risultati

Questo esempio aumenta il valore della proprietà MaximumReceivedObjectSizeMB a 20. Questo comando richiede anche di riavviare il servizio WinRM . La modifica non è effettiva fino al riavvio del servizio WinRM .

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\IncObj\InitializationParameters

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "Restart-Service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Esempio 3: Visualizzare i risultati in modi diversi

In questo esempio, Set-PSSessionConfiguration lo script di avvio nella configurazione della sessione MaintenanceShell viene modificato in Maintenance.ps1. L'output mostra la modifica e richiede di riavviare il servizio WinRM . La risposta è y (sì).

Get-PSSessionConfiguration ottiene la configurazione della sessione MaintenanceShell . L'operatore pipeline (|) invia i risultati del comando a Format-List, che visualizza tutte le proprietà dell'oggetto di configurazione in un elenco. Successivamente, utilizzando il provider WSMan, vengono visualizzati i parametri di inizializzazione per la configurazione di MaintenanceShell . Get-ChildItem ottiene gli elementi figlio nel nodo InitializationParameters per il plug-in MaintenanceShell . Per altre informazioni sul provider WSMan, digitare Get-Help WSMan.

Set-PSSessionConfiguration -Name "MaintenanceShell" -StartupScript "C:\ps-test\Maintenance.ps1"

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName            ParamValue
---------            ----------
startupscript        C:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run
the command "Restart-Service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y


Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : C:\ps-test\Maintenance.ps1
ResourceUri      : http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript C:\ps-test\Maintenance.ps1

Parametri

-AccessMode

Abilita e disabilita la configurazione della sessione e determina se può essere usata per sessioni remote o locali nel computer. I valori accettabili per questo parametro sono:

  • Disabled. Disabilita la configurazione della sessione. Non può essere utilizzato per l'accesso remoto o locale al computer. Questo valore imposta la proprietà Enabled della configurazione della sessione (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) su False.
  • Local. Aggiunge una voce Network_Deny_All al descrittore di sicurezza della configurazione della sessione. Gli utenti del computer locale possono utilizzare la configurazione della sessione per creare una sessione di loopback locale sullo stesso computer, ma agli utenti remoti viene negato l'accesso.
  • Remote. Rimuove le voci Deny_All e Network_Deny_All dai descrittori di sicurezza della configurazione della sessione. Gli utenti dei computer locali e remoti possono utilizzare la configurazione della sessione per creare sessioni ed eseguire comandi su questo computer.

Il valore predefinito è Remote.

Altri cmdlet possono eseguire l'override del valore di questo parametro in un secondo momento. Ad esempio, il Enable-PSRemoting cmdlet abilita tutte le configurazioni di sessione nel computer e consente l'accesso remoto a tali configurazioni, mentre il cmdlet consente solo l'accesso Disable-PSRemoting locale a tutte le configurazioni di sessione nel computer.

Questo parametro è stato introdotto in PowerShell 3.0.

Proprietà dei parametri

Tipo:PSSessionConfigurationAccessMode
Valore predefinito:None
Valori accettati:Disabled, Local, Remote
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

-ApplicationBase

Specifica il percorso del file di assembly (*.dll) specificato nel valore del parametro AssemblyName .

Proprietà dei parametri

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

Set di parametri

NameParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
AssemblyNameParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AssemblyName

Specifica il nome dell'assembly. Questo cmdlet crea una configurazione di sessione basata su una classe definita in un assembly.

Immettere il nome file o il percorso completo di un file di assembly .dll che definisce una configurazione di sessione. Se si immette solo il nome del file, è possibile immettere il percorso nel valore del parametro ApplicationBase .

Proprietà dei parametri

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

Set di parametri

AssemblyNameParameterSet
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ConfigurationTypeName

Specifica il tipo di configurazione della sessione definita nell'assembly nel parametro AssemblyName . Il tipo specificato deve implementare la classe System.Management.Automation.Remoting.PSSessionConfiguration.

Questo parametro è obbligatorio quando si specifica il nome di un assembly.

Proprietà dei parametri

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

Set di parametri

AssemblyNameParameterSet
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-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

Elimina tutte le richieste dell'utente e riavvia il servizio Gestione remota Windows 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

-MaximumReceivedDataSizePerCommandMB

Specifica il limite per la quantità di dati che possono essere inviati al computer in un singolo comando remoto. Immettere le dimensioni dei dati in megabyte (MB). Il valore predefinito è 50.

Se nel tipo di configurazione specificato nel parametro ConfigurationTypeName viene definito un limite per le dimensioni dei dati, viene utilizzato il limite nel tipo di configurazione. Il valore di questo parametro viene ignorato.

Proprietà dei parametri

Tipo:

Nullable<T>[Double]

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

-MaximumReceivedObjectSizeMB

Specifica i limiti per la quantità di dati che possono essere inviati al computer in un singolo oggetto. Immettere le dimensioni dei dati in megabyte. Il valore predefinito è 10.

Se nel tipo di configurazione specificato nel parametro ConfigurationTypeName viene definito un limite per le dimensioni degli oggetti, viene utilizzato il limite nel tipo di configurazione. Il valore di questo parametro viene ignorato.

Proprietà dei parametri

Tipo:

Nullable<T>[Double]

Valore predefinito:10
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

-ModulesToImport

Specifica i moduli e gli snap-in che vengono importati automaticamente nelle sessioni che utilizzano la configurazione di sessione. Immettere i nomi del modulo e dello snap-in.

Per impostazione predefinita, solo il modulo Microsoft.PowerShell.Core viene importato nelle sessioni, ma a meno che i cmdlet non siano esclusi, è possibile usare i Import-Module cmdlet e Add-PSSnapin per aggiungere moduli e snap-in alla sessione.

I moduli specificati in questo valore di parametro vengono importati in aggiunta ai moduli specificati nel file di configurazione della sessione (New-PSSessionConfigurationFile). Tuttavia, le impostazioni nel file di configurazione della sessione possono nascondere i comandi esportati dai moduli o impedire agli utenti di usarli.

I moduli specificati in questo valore di parametro sostituiscono l'elenco dei moduli specificati con il parametro ModulesToImport del Register-PSSessionConfiguration cmdlet.

Questo parametro è stato introdotto in PowerShell 3.0.

Proprietà dei parametri

Tipo:

Object[]

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

Set di parametri

NameParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
AssemblyNameParameterSet
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 il nome della configurazione della sessione che si desidera modificare.

Non è possibile utilizzare questo parametro per modificare il nome della configurazione della sessione.

Proprietà dei parametri

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

Set di parametri

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

-NoServiceRestart

Non riavvia il servizio Gestione remota Windows ed elimina la richiesta di riavvio del servizio.

Per impostazione predefinita, quando si esegue Set-PSSessionConfiguration, viene richiesto di riavviare il servizio Gestione remota Windows per rendere effettiva la nuova configurazione della sessione. Fino al riavvio del servizio WinRM, la nuova configurazione della sessione non è effettiva.

Per riavviare il servizio Gestione remota Windows senza chiedere conferma, usare il parametro Force . Per riavviare manualmente il servizio WinRM , usare il cmdlet .

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

-Path

Specifica il percorso di un file di configurazione della sessione (.pssc), ad esempio quello creato dal New-PSSessionConfigurationFile cmdlet . Se si omette il percorso, il valore predefinito è la directory corrente.

Per informazioni su come modificare un file di configurazione della sessione, vedere l'argomento della Guida relativo al New-PSSessionConfigurationFile cmdlet.

Questo parametro è stato introdotto in PowerShell 3.0.

Proprietà dei parametri

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

Set di parametri

SessionConfigurationFile
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PSVersion

Specifica la versione di PowerShell nelle sessioni che usano questa configurazione di sessione.

Il valore di questo parametro ha la precedenza sul valore della chiave PowerShellVersion nel file di configurazione della sessione.

Questo parametro è stato introdotto in PowerShell 3.0.

Proprietà dei parametri

Tipo:Version
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Versione di PowerShell

Set di parametri

NameParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
AssemblyNameParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-RunAsCredential

Specifica le credenziali per i comandi nella sessione. Per impostazione predefinita, i comandi vengono eseguiti con le autorizzazioni dell'utente corrente.

Questo parametro è stato introdotto in PowerShell 3.0.

Proprietà dei parametri

Tipo:PSCredential
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 una stringa SDDL (Security Descriptor Definition Language) diversa per la configurazione.

Questa stringa determina le autorizzazioni necessarie per usare la nuova configurazione di sessione. Per usare una configurazione di sessione in una sessione, gli utenti devono disporre almeno Execute(Invoke) dell'autorizzazione per la configurazione.

Per usare il descrittore di sicurezza predefinito per la configurazione, immettere una stringa vuota ("") o un valore .$null Il valore predefinito è il file SDDL radice nell'unità WSMan: .

Se il descrittore di sicurezza è complesso, è consigliabile utilizzare il parametro ShowSecurityDescriptorUI anziché questo. Non è possibile utilizzare entrambi i parametri nello stesso comando.

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

-SessionTypeOption

Specifica le opzioni specifiche del tipo per la configurazione della sessione. Immettere un oggetto opzioni del tipo di sessione, ad esempio l'oggetto PSWorkflowExecutionOption restituito dal cmdlet New-PSWorkflowExecutionOption.

Le opzioni delle sessioni che usano la configurazione della sessione sono determinate dai valori delle opzioni di sessione e dalle opzioni di configurazione della sessione. Se non specificato, le opzioni impostate nella sessione, ad esempio con il New-PSSessionOption cmdlet , hanno la precedenza sulle opzioni impostate nella configurazione della sessione. Tuttavia, i valori delle opzioni di sessione non possono superare i valori massimi impostati nella configurazione della sessione.

Questo parametro è stato introdotto in PowerShell 3.0.

Proprietà dei parametri

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

Set di parametri

NameParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
AssemblyNameParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ShowSecurityDescriptorUI

Quando si usa questo parametro, il cmdlet apre una finestra delle proprietà che consente di creare un nuovo SDDL per la configurazione della sessione. La finestra delle proprietà viene visualizzata dopo l'esecuzione del Set-PSSessionConfiguration comando e quindi il riavvio del servizio Gestione remota Windows .

Quando si impostano le autorizzazioni per la configurazione, tenere presente che gli utenti devono avere almeno Execute(Invoke) l'autorizzazione per usare la configurazione della sessione in una sessione.

Non è possibile utilizzare il parametro SecurityDescriptorSDDL e questo parametro nello stesso comando.

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

-StartupScript

Specifica lo script di avvio per la configurazione. Immettere il percorso completo di uno script di PowerShell. Lo script specificato viene eseguito nella nuova sessione che usa la configurazione di sessione.

Per eliminare uno script di avvio da una configurazione di sessione, immettere una stringa vuota ("") o un valore di $null.

È possibile utilizzare uno script di avvio per configurare ulteriormente la sessione utente. Se lo script genera un errore, anche se non irreversibile, la sessione non viene creata e il New-PSSession comando non riesce.

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

-ThreadApartmentState

Specifica lo stato apartment del modulo di threading da usare. I valori accettabili sono:

  • Unknown
  • MTA
  • STA

Proprietà dei parametri

Tipo:ApartmentState
Valore predefinito:None
Valori accettati:STA, MTA, Unknown
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

-ThreadOptions

Specifica l'impostazione delle opzioni di thread nella configurazione. Questa impostazione definisce il modo in cui i thread vengono creati e utilizzati quando viene eseguito un comando nella sessione. I valori accettabili per questo parametro sono:

  • Default
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

Il valore predefinito è UseCurrentThread.

Per altre informazioni, vedere 'enumerazione PSThreadOptions.

Proprietà dei parametri

Tipo:PSThreadOptions
Valore predefinito:None
Valori accettati:Default, UseNewThread, ReuseThread, UseCurrentThread
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

-TransportOption

Specifica le opzioni di trasporto per la configurazione della sessione. Immettere un oggetto opzioni di trasporto, ad esempio l'oggetto WSManConfigurationOption restituito dal New-PSTransportOption cmdlet.

Le opzioni delle sessioni che usano la configurazione della sessione sono determinate dai valori delle opzioni di sessione e dalle opzioni di configurazione della sessione. Se non specificato, le opzioni impostate nella sessione, ad esempio con il New-PSSessionOption cmdlet , hanno la precedenza sulle opzioni impostate nella configurazione della sessione. Tuttavia, i valori delle opzioni di sessione non possono superare i valori massimi impostati nella configurazione della sessione.

Questo parametro è stato introdotto in PowerShell 3.0.

Proprietà dei parametri

Tipo:PSTransportOption
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

-UseSharedProcess

Usare un solo processo per ospitare tutte le sessioni avviate dallo stesso utente e usare la stessa configurazione di sessione. Per impostazione predefinita, ogni sessione è ospitata nel proprio processo.

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

None

Gli oggetti non possono essere inviati tramite pipe a questo cmdlet.

Output

WSManConfigLeafElement

Note

Per eseguire questo cmdlet, avviare PowerShell usando l'opzione Esegui come amministratore.

Il Set-PSSessionConfiguration cmdlet non modifica il nome della configurazione e il provider WSMan non supporta il Rename-Item cmdlet. Per modificare il nome di una configurazione di sessione, utilizzare il Unregister-PSSessionConfiguration cmdlet per eliminare la configurazione e quindi utilizzare il Register-PSSessionConfiguration cmdlet per creare e registrare una nuova configurazione di sessione.

È possibile usare il Set-PSSessionConfiguration cmdlet per modificare le configurazioni predefinite Microsoft.PowerShell e Microsoft.PowerShell32 di sessione. Non sono protetti. Per ripristinare la versione originale di una configurazione di sessione predefinita, utilizzare il Unregister-PSSessionConfiguration cmdlet per eliminare la configurazione di sessione predefinita e quindi utilizzare il Enable-PSRemoting cmdlet per ripristinarla.

Le proprietà di un oggetto di configurazione sessione variano in base alle opzioni impostate per la configurazione della sessione e ai valori di tali opzioni. Inoltre, le configurazioni di sessione che usano un file di configurazione di sessione hanno proprietà aggiuntive.

È possibile usare i comandi nell'unità WSMan: per modificare le proprietà delle configurazioni di sessione. Tuttavia, non è possibile usare l'unità WSMan: in PowerShell 2.0 per modificare le proprietà di configurazione della sessione introdotte in PowerShell 3.0, ad esempio OutputBufferingMode. I comandi di Windows PowerShell 2.0 non generano un errore, ma sono inefficaci. Per modificare le proprietà introdotte in PowerShell 3.0, usare l'unità WSMan: in PowerShell 3.0 o versione successiva.