New-CsServerApplication
上一次修改主题: 2012-03-26
创建新的服务器应用程序。服务器应用程序是 Microsoft Lync Server 2010 所托管的应用程序。
语法
New-CsServerApplication -Identity <XdsIdentity> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]
New-CsServerApplication -Name <String> -Parent <String> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]
详细说明
服务器应用程序是指在 Microsoft Lync Server 2010 下运行的各个程序。New-CsServerApplication cmdlet 为管理员提供了一种配置新服务器应用程序的方式。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsServerApplication cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsServerApplication"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
Xds 标识 |
要创建的服务器应用程序的唯一标识符。服务器应用程序标识由托管应用程序的服务加上应用程序名称组成。例如,名为 QoEAgent 的服务器应用程序的标识可能类似于这种形式:service:Registrar:atl-cs-001.litwareinc.com/QoEAgent。 |
Parent |
必需 |
字符串 |
指定将托管新服务器应用程序的服务。如果使用 -Identity 参数,则不需要使用 -Parent 或 -Name 参数;这是因为应用程序的 Identity 参数已含有 Parent 和 Name 属性的值。但是,可以通过改用 Parent 和 Name 参数而省略 Identity 参数。在这种情况下,Parent 参数的用法需要类似于这种形式:-Parent "Registrar:atl-cs-001.litwareinc.com"。 |
Name |
必需 |
字符串 |
服务的友好名称。如果使用 Identity 参数,则在创建新服务时不需要加入 Name 参数;而是要用应用程序 Identity 参数的名称部分填充 Name 属性。例如,如果用 service:Registrar:atl-cs-001.litwareinc.com/TestService 这个 Identity 创建新应用程序,则该应用程序将自动命名为 TestService。只有在使用 Parent 参数时才需要 Name 参数。 |
Uri |
必需 |
字符串 |
应用程序的唯一统一资源标识符 (URI)。例如,QoEAgent 应用程序的 URI 为 https://www.microsoft.com/LCS/QoEAgent。 |
Enabled |
可选 |
布尔值 |
将此值设置为 True 可启用应用程序。将此值设置为 False 可禁用应用程序。如果未指定此参数,则 Enabled 属性将设置为 False 并且新应用程序将被禁用。 |
Critical |
可选 |
布尔值 |
如果设置为 True,则仅当可以启动相应的应用程序时,才会启动 Lync Server。如果设置为 False,无论该应用程序能否启动,Lync Server 都将启动。如果未指定此参数,则 Critical 属性将设置为 True。 |
ScriptName |
可选 |
字符串 |
应用程序使用的 Microsoft SIP 处理语言 (MSPL) 脚本的路径(如果适用)。MSPL 是用于筛选和路由 SIP 消息的脚本语言。 |
Priority |
可选 |
整数 |
指示服务器应用程序的执行顺序。首先启动优先级为 0 的应用程序;其次启动优先级为 1 的应用程序,以此类推。注意,每个托管服务器应用程序的服务都有其自身的一组唯一的优先级。例如,Registrar 服务可能托管三个应用程序,对应的优先级分别为 0、1 和 2。同样,边缘服务器服务可能包含四个应用程序,这些应用程序的优先级分别为 0、1、2 和 3。 如果不指定优先级,则会自动将应用程序添加到优先级列表的底部。如果添加或删除应用程序,则将相应地调整其他应用程序的优先级。例如,如果删除优先级为 0 的应用程序,则以前优先级为 1 的应用程序会自动将其优先级设置为 0。 |
InMemory |
可选 |
开关参数 |
创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsServerApplication 不接受通过管道传递的输入。
返回类型
New-CsServerApplication 创建 Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application 对象的新实例。
示例
-------------------------- 示例 1 ------------------------
New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False
示例 1 用 EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor 这个 Identity 创建了一个新的服务器应用程序。除了指定 Identity 之外,还加入了 Uri 和 Critical 参数;这两个参数用于指定应用程序 URI 以及指示不将该应用程序视为至关重要。
-------------------------- 示例 2 ------------------------
$x = New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -InMemory
$x.Uri = "http://www.litwareinc.com/edgemonitor"
$x.Critical = $False
Set-CsServerApplication -Instance $x
示例 2 中显示的命令演示了如何能够创建一个最初仅存在于内存中的新服务器应用程序。为此,第一个命令调用 New-CsServerApplication 以及两个参数:Identity(它指定应用程序的 Identity)和 InMemory(它指示应仅在内存中创建新应用程序)。生成的服务器应用程序对象随后将存储在变量 $x 中。
创建此虚拟服务器应用程序后,使用命令 2 和 3 分别修改 Uri 和 Critical 属性的值。最后,使用命令 4 将虚拟服务器应用程序传输到真实的服务器应用程序中。注意,必须执行最后这个命令。如果不调用 Set-CsServerApplication,则不会为 EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor 配置任何应用程序,并且在终止 Windows PowerShell 会话或删除变量 $x 后,虚拟应用程序就会马上消失。