Get-PSSessionConfiguration
Ottiene le configurazioni di sessione registrate nel computer.
Sintassi
Get-PSSessionConfiguration [[-Name] <string[]>] [<CommonParameters>]
Descrizione
Il cmdlet Get-PSSessionConfiguration ottiene le configurazioni di sessione registrate nel computer locale. Si tratta di un cmdlet avanzato progettato per essere utilizzato da amministratori di sistema per gestire le configurazioni di sessione personalizzate degli utenti.
Per creare e registrare una configurazione di sessione, utilizzare il cmdlet Register-PSSessionConfiguration.
Parametri
-Name <string[]>
Ottiene solo le configurazioni di sessione con il modello di nome o il nome specificato. Immettere uno o più nomi di configurazioni di sessione. È consentito l'utilizzo di caratteri jolly.
Obbligatorio? |
false |
Posizione? |
1 |
Valore predefinito |
All session configurations on the local computer |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
true |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
Nessuno Non è possibile reindirizzare l'input a questo cmdlet. |
Output |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration |
Note
Per eseguire questo cmdlet in Windows Vista, Windows Server 2008 e nelle versioni successive di Windows, è necessario aprire Windows PowerShell con l'opzione "Esegui come amministratore".
Per visualizzare le configurazioni di sessione nel computer, è necessario essere un membro del gruppo Administrators nel computer.
Per eseguire un comando Get-PSSessionConfiguration in un computer remoto, è necessario abilitare l'autenticazione CredSSP (Credential Security Service Provider) nelle impostazioni client nel computer locale (tramite il cmdlet Enable-WSManCredSSP) e nelle impostazioni servizio nel computer remoto, nonché utilizzare il valore CredSSP del parametro Authentication per stabilire la sessione remota. In caso contrario, l'accesso viene negato.
Esempio 1
C:\PS>get-pssessionconfiguration
Descrizione
-----------
Con questo comando si ottengono le configurazioni di sessione nel computer.
Esempio 2
C:\PS>get-pssessionconfiguration -name Microsoft*
Name PSVersion StartupScript Permission
---- --------- ------------- ----------
microsoft.powershell 2.0 BUILTIN\Administrators AccessAll...
microsoft.powershell32 2.0 BUILTIN\Administrators AccessAll...
Descrizione
-----------
Questo comando utilizza il parametro Name di Get-PSSessionConfiguration per ottenere solo le configurazioni di sessione con nomi che iniziano con "Microsoft".
Con questo comando si ottengono le due configurazioni di sessione predefinite fornite con Windows PowerShell.
Esempio 3
C:\PS>Get-PSSessionConfiguration -name microsoft.powershell | get-member
TypeName: Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Capability NoteProperty System.Object[] Capability=System.Object[]
ExactMatch NoteProperty System.String ExactMatch=False
Filename NoteProperty System.String Filename=%windir%\system32\pwrshplugin.dll
lang NoteProperty System.String lang=en-US
Name NoteProperty System.String Name=microsoft.powershell
PSVersion NoteProperty System.String PSVersion=2.0
ResourceUri NoteProperty System.String ResourceUri=https://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion NoteProperty System.String SDKVersion=1
SecurityDescriptorSddl NoteProperty System.String SecurityDescriptorSddl=O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
SupportsOptions NoteProperty System.String SupportsOptions=true
Uri NoteProperty System.String Uri=https://schemas.microsoft.com/powershell/microsoft.powershell
xmlns NoteProperty System.String xmlns=https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
XmlRenderingType NoteProperty System.String XmlRenderingType=text
Permission ScriptProperty System.Object Permission {get=trap { continue; }...
C:\PS> Get-PSSessionConfiguration -name microsoft.powershell | format-list -property *
Name : microsoft.powershell
Filename : %windir%\system32\pwrshplugin.dll
SDKVersion : 1
XmlRenderingType : text
lang : en-US
PSVersion : 2.0
ResourceUri : https://schemas.microsoft.com/powershell/microsoft.powershell
SupportsOptions : true
Capability : {Shell}
Uri : https://schemas.microsoft.com/powershell/microsoft.powershell
SecurityDescriptorSddl : O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
ExactMatch : False
xmlns : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Permission : BUILTIN\Administrators AccessAllowed
Descrizione
-----------
Questi comandi esaminano l'oggetto PSSessionConfiguration restituito da Get-PSSessionConfiguration.
Con il primo comando viene utilizzato il cmdlet Get-PSSessionConfiguration per ottenere la configurazione predefinita Microsoft.PowerShell.
Con il secondo comando viene utilizzato un operatore pipeline (|) per inviare l'oggetto restituito da Get-PSSessionConfiguration al cmdlet Get-Member. L'output mostra le proprietà e i metodi dell'oggetto.
Con il terzo comando viene inviato lo stesso oggetto al cmdlet Format-List. Con il parametro Property impostato sul valore * (tutti) Format-List elenca tutte le proprietà e i valori di proprietà dell'oggetto.
L'output di questo comando dispone di informazioni molto utili, inclusi il percorso del file con estensione dll che implementa il tipo di configurazione, l'URI (Uniform Resource Identifier) della risorsa per l'endpoint creato e l'SDDL (Security Descriptor Definition Language) per la configurazione.
Esempio 4
C:\PS>dir wsman:\localhost\plugin
WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin
Name Type Keys
---- ---- ----
Event Forwarding Plugin Container {Name=Event Forwarding Plugin}
MaintenanceShell Container {Name=MaintenanceShell}
microsoft.powershell Container {Name=microsoft.powershell}
microsoft.powershell32 Container {Name=microsoft.powershell32}
WMI Provider Container {Name=WMI Provider}
Descrizione
-----------
Nel comando viene utilizzato il cmdlet Get-ChildItem (alias = dir) nell'unità WSMAN: del provider per analizzare il contenuto del nodo Plugin.
Si tratta di un'altra modalità per analizzare le configurazioni di sessione nel computer.
Il nodo Plugin contiene oggetti ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement) che rappresentano le configurazioni di sessione registrate di Windows PowerShell, insieme ad altri plug-in per WS-Management.
Esempio 5
C:\PS>enable-wsmanCredSSP -delegate server02
C:\PS> connect-wsman server02
C:\PS> set-item wsman:\server02*\service\auth\credSSP -value $true
C:\PS> invoke-command -scriptblock {Get-PSSessionConfiguration} -computername Server02 -authentication CredSSP -credential Domain01\Admin01
Name PSVersion StartupScript Permission PSComputerName
---- --------- ------------- ---------- --------------
microsoft.powershell 2.0 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
microsoft.powershell32 2.0 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
MyX86Shell 2.0 c:\test\x86Shell.ps1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
Descrizione
-----------
In questo esempio viene illustrato come eseguire un comando Get-PSSessionConfiguration in un computer remoto. Per questo comando è necessario che la delega CredSSP sia abilitata nelle impostazioni client del computer locale e nelle impostazioni servizio nel computer remoto. Per eseguire i comandi in questo esempio, è necessario essere un membro del gruppo Administrators nel computer locale e nel computer remoto.
Con il primo comando viene utilizzato il cmdlet Enable-WSManCredSSP per abilitare la delega CredSSP dal computer locale Server01 al computer remoto Server02. L'impostazione client CredSSP viene configurata nel computer locale.
Con il secondo comando viene utilizzato il cmdlet Connect-WSMan per la connessione al computer Server02. Questa azione consente di aggiungere un nodo per il computer Server02 all'unità WSMan: nel computer locale, consentendo la visualizzazione e la modifica delle impostazioni di WS-Management nel computer Server02.
Nel terzo comando viene utilizzato il cmdlet Set-Item per modificare il valore dell'elemento CredSSP nel nodo Service del computer Server02 in True. Le impostazioni servizio vengono configurate nel computer remoto.
Con il quarto comando viene utilizzato il cmdlet Invoke-Command per eseguire un comando Get-PSSessionConfiguration nel computer Server02. Vengono utilizzati il parametro Credential e il parametro Authentication con un valore di CredSSP.
Esempio 6
C:\PS>(get-PSSessionConfiguration -name CustomShell).resourceURI
https://schemas.microsoft.com/powershell/microsoft.CustomShell
Descrizione
-----------
Con questo comando viene utilizzato il cmdlet Get-PSSessionConfiguration per ottenere l'URI di risorsa di una configurazione di sessione.
Questo comando è utile per l'impostazione del valore della variabile di preferenza $PSSessionConfigurationName che accetta un URI di risorsa.
Con la variabile $PSSessionConfiguationName viene specificata la configurazione predefinita utilizzata quando si crea una sessione. Questa variabile viene impostata nel computer locale, ma specifica una configurazione nel computer remoto. Per ulteriori informazioni sulla variabile $PSSessionConfiguration, vedere about_Preference_Variables.
Vedere anche
Concetti
about_Session_Configurations
Disable-PSSessionConfiguration
Enable-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider