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 变量中。

第二个命令注册新的 shell。该命令使用 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。