Register-PSSessionConfiguration

Register-PSSessionConfiguration [-AssemblyName] <string> [-ConfigurationTypeName] <string> [-ApplicationBase <string>] [-Name] <string> [-Force] [-MaximumReceivedDataSizePerCommandMB <double>] [-MaximumReceivedObjectSizeMB <double>] [-NoServiceRestart] [-ProcessorArchitecture <string>] [-SecurityDescriptorSDDL <string>] [-ShowSecurityDescriptorUI] [-StartupScript <string>] [-ThreadApartmentState {<STA> | <MTA> | <Unknown>}] [-ThreadOptions {<Default> | <UseNewThread> | <ReuseThread> | <UseCurrentThread>}] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>register-pssessionConfiguration -name NewShell -applicationBase c:\MyShells\ -assemblyName MyShell.dll -configurationTypeName MyClass

Descrizione
-----------
Questo comando registra la configurazione di sessione NewShell. Utilizza i parametri ApplicationName e ApplicationBase per specificare il percorso del file MyShell.dll che specifica i cmdlet e i provider nella configurazione di sessione. Utilizza inoltre il parametro ConfigurationTypeName per specificare una nuova classe che configuri ulteriormente la sessione.

Per utilizzare questa configurazione, gli utenti dovrebbero digitare "new-pssession -configurationname newshell".

C:\PS>register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

Descrizione
-----------
Questo comando registra la configurazione MaintenanceShell nel computer locale. Viene utilizzato il parametro StartupScript per specificare lo script Maintenance.ps1.

Quando un utente utilizza un comando New-PSSession e seleziona la configurazione MaintenanceShell, viene eseguito lo script Maintenance.ps1 nella nuova sessione. Lo script può configurare la sessione, includendo l'importazione di moduli, l'aggiunta di snap-in di Windows PowerShell e l'impostazione dei criteri di esecuzione per la sessione. Se lo script genera errori, inclusi quelli non fatali, il comando New-PSSession ha esito negativo.

C:\PS>$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FA;SA;GWGX;;WD)"

C:\PS> register-pssessionconfiguration -name AdminShell -securityDescriptorSDDL $sddl -maximumReceivedObjectSizeMB 20 -startupScript c:\scripts\AdminShell.ps1

Descrizione
-----------
In questo esempio viene effettuata la registrazione della configurazione di sessione AdminShell. 

Il primo comando consente di salvare un SDDL personalizzato nella variabile $sddl. 

Con il secondo comando si registra la nuova shell. Con il comando si utilizza il parametro SecurityDescritorSDDL per specificare l'SDDL nel valore della variabile $sddl e il parametro MaximumReceivedObjectSizeMB per aumentare il limite relativo alle dimensioni dell'oggetto. Viene inoltre utilizzato il parametro StartupScript per specificare uno script che configuri la sessione.

In alternativa all'utilizzo del parametro SecurityDescriptorSDDL, è possibile utilizzare il parametro ShowSecurityDescriptorUI che visualizza una finestra delle proprietà utilizzabile per impostare le autorizzazioni per la configurazione di sessione. Quando si fa clic su "OK" nella finestra delle proprietà, lo strumento genera un SDDL per la configurazione di sessione.

C:\PS>$s = register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

C:\PS> $s

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

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}


C:\PS> $s.getType().fullname
TypeName: Microsoft.WSMan.Management.WSManConfigContainerElement


C:\PS> $s | format-list -property *

PSPath            : Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell
PSParentPath      : Microsoft.WSMan.Management\WSMan::localhost\Plugin
PSChildName       : MaintenanceShell
PSDrive           : WSMan
PSProvider        : Microsoft.WSMan.Management\WSMan
PSIsContainer     : True
Keys              : {Name=MaintenanceShell}
Name              : MaintenanceShell
TypeNameOfElement : Container


C:\PS> dir wsman:\localhost\plugin

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}

Descrizione
-----------
In questo esempio viene indicato che un comando Register-PSSessionConfiguration restituisce WSManConfigContainerElement. Viene inoltre illustrato come trovare gli elementi del contenitore nell'unità WSMan:.

Con il primo comando si utilizza il cmdlet Register-PSSessionConfiguration per registrare la configurazione MaintenanceShell. Viene salvato l'oggetto restituito dal cmdlet nella variabile $s.

Con il secondo comando viene visualizzato il contenuto della variabile $s. 

Con il terzo comando si utilizza il metodo GetType e la relativa proprietà FullName per visualizzare il nome del tipo dell'oggetto restituito da Register-PSSessionConfiguration.

Con il quarto comando si utilizza il cmdlet Format-List per visualizzare tutte le proprietà dell'oggetto restituito da Register-PSSessionConfiguration in un elenco. La proprietà PSPath mostra che l'oggetto viene archiviato in una directory dell'unità WSMan:.

Con il quinto comando si utilizza il cmdlet Get-ChildItem per visualizzare gli elementi nel percorso WSMan:\LocalHost\PlugIn. Sono incluse la nuova configurazione MaintenanceShell e le due configurazioni predefinite fornite con Windows PowerShell.

C:\PS>register-pssessionconfiguration -name WithProfile -startupScript add-profile.ps1

# Add-Profile.ps1

. c:\users\admin01\documents\windowspowershell\profile.ps1

Descrizione
-----------
Con questo comando viene creata e registrata la configurazione di sessione WithProfile nel computer locale. Con il comando si utilizza il parametro StartupScript per indicare a Windows PowerShell di eseguire lo script specificato in qualsiasi sessione che utilizza la configurazione di sessione.

Viene inoltre visualizzato il contenuto dello script specificato, Add-Profile.ps1. Lo script contiene un singolo comando che utilizza il dot sourcing per eseguire il profilo CurrentUserAllHosts dell'utente nell'ambito corrente della sessione.

Per ulteriori informazioni sui profili, vedere about_Profiles. Per ulteriori informazioni sul dot sourcing, vedere about_Scopes.