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

描述
-----------
這個命令會註冊 NewShell 工作階段設定。它會使用 ApplicationName 和 ApplicationBase 參數來指定 MyShell.dll 檔案的位置，而該檔案會指定工作階段設定中的 Cmdlet 和提供者。此外，它也會使用 ConfigurationTypeName 參數來指定進一步設定工作階段的新類別。

若要使用這項設定，使用者會輸入 "new-pssession -configurationname newshell"。

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

描述
-----------
這個命令會在本機電腦上註冊 MaintenanceShell 設定。此命令會使用 StartupScript 參數來指定 Maintenance.ps1 指令碼。

當使用者使用 New-PSSession 命令並選取 MaintenanceShell 設定時，Maintenance.ps1 指令碼就會在新的工作階段中執行。該指令碼可以設定工作階段，包括匯入模組、新增 Windows PowerShell 嵌入式管理單元，以及設定工作階段的執行原則。如果該指令碼產生任何錯誤，包括非終止錯誤，New-PSSession 命令就會失敗。

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

描述
-----------
這個範例會註冊 AdminShell 工作階段設定。

第一個命令會將自訂 SDDL 儲存在 $sddl 變數中。

第二個命令會註冊新的殼層。此命令會使用 SecurityDescritorSDDL 參數來指定 $sddl 變數值中的 SDDL，並使用 MaximumReceivedObjectSizeMB 參數來提高物件大小限制。此外，它也會使用 StartupScript 參數來指定設定工作階段的指令碼。

除了使用 SecurityDescriptorSDDL 參數以外，您也可以使用 ShowSecurityDescriptorUI 參數，以便顯示可用來設定工作階段設定之權限的內容表。當您在內容表中按一下 [確定] 時，此工具就會產生工作階段設定的 SDDL。

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}

描述
-----------
這個範例會示範 Register-PSSessionConfiguration 命令將傳回 WSManConfigContainerElement，同時示範如何在 WSMan: 磁碟機中尋找容器元素。

第一個命令會使用 Register-PSSessionConfiguration Cmdlet 來註冊 MaintenanceShell 設定。它會將該 Cmdlet 所傳回的物件儲存在 $s 變數中。

第二個命令會顯示 $s 變數的內容。

第三個命令會使用 GetType 方法及其 FullName 屬性來顯示 Register-PSSessionConfiguration 所傳回之物件的類型名稱。

第四個命令會使用 Format-List Cmdlet，以清單顯示 Register-PSSessionConfiguration 所傳回之物件的所有屬性。PSPath 屬性會顯示該物件儲存在 WSMan: 磁碟機的目錄中。

第五個命令會使用 Get-ChildItem Cmdlet 來顯示 WSMan:\LocalHost\PlugIn 路徑中的項目。這些項目包括新的 MaintenanceShell 設定以及 Windows PowerShell 隨附的兩個預設設定。

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

# Add-Profile.ps1

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

描述
-----------
這個命令會在本機電腦上建立並註冊 WithProfile 工作階段設定。此命令會使用 StartupScript 參數來指示 Windows PowerShell 在使用該工作階段設定的任何工作階段設定中執行指定的指令碼。

系統也會顯示指定之指令碼 Add-Profile.ps1 的內容。此指令碼包含使用以句號表示起點的單一命令，可在工作階段的目前範圍中執行使用者的 CurrentUserAllHosts 設定檔。

如需設定檔的詳細資訊，請參閱 about_Profiles。如需以句號表示起點的詳細資訊，請參閱 about_Scopes。