Condividi tramite

  • Articolo

New-CsServerApplication

 

Ultima modifica dell'argomento: 2012-03-26

Consente di creare una nuova applicazione server. Le applicazioni server sono applicazioni ospitate da Microsoft Lync Server 2010.

Sintassi

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>]]

Descrizione dettagliata

Le applicazioni server fanno riferimento ai singoli programmi eseguiti in Microsoft Lync Server 2010. Il cmdlet New-CsServerApplication consente agli amministratori di configurare nuove applicazioni server.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsServerApplication può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsServerApplication"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco dell'applicazione server da creare. Le identità (Identity) dell'applicazione server sono composte dal servizio in cui viene ospitata l'applicazione e dal nome dell'applicazione. Ad esempio, l'applicazione server denominata QoEAgent potrebbe avere un'identità (Identity) simile alla seguente: service:Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Parent

Obbligatorio

Stringa

Indica il servizio che ospiterà la nuova applicazione server. Se si utilizza il parametro Identity, non è necessario utilizzare il parametro Parent o il parametro Name perché l'identità (Identity) dell'applicazione combina i valori delle proprietà Parent e Name. Tuttavia, è possibile omettere il parametro Identity e utilizzare invece i parametri Parent e Name. In questo caso, il parametro Parent dovrà essere simile al seguente: -Parent "Registrar:atl-cs-001.litwareinc.com".

Name

Obbligatorio

Stringa

Nome descrittivo del servizio. Se si utilizza il parametro Identity, non è necessario includere il parametro Name durante la creazione di un nuovo servizio. Infatti, nella proprietà Name verrà automaticamente inserita la parte del nome dell'identità (Identity) dell'applicazione. Ad esempio, se si crea una nuova applicazione con Identity service:Registrar:atl-cs-001.litwareinc.com/TestService l'applicazione verrà denominata automaticamente TestService. Il parametro Name è obbligatorio solo se si utilizza il parametro Parent.

Uri

Obbligatorio

Stringa

URI (Uniform Resource Identifier) dell'applicazione. Ad esempio, l'applicazione QoEAgent ha l'URI https://www.microsoft.com/LCS/QoEAgent.

Enabled

Facoltativo

Booleano

Impostare questo valore su True per abilitare l'applicazione. Impostare questo valore su False per disabilitare l'applicazione. Se questo parametro non viene specificato, la proprietà Enabled verrà impostata su False e la nuova applicazione risulterà disabilitata.

Critical

Facoltativo

Booleano

Se impostato su True, Lync Server non verrà avviato a meno che l'applicazione non possa essere avviata. Se impostato su False, Lync Server verrà avviato indipendentemente dal fatto che l'applicazione possa essere avviata o meno. Se questo parametro non viene specificato, la proprietà Critical verrà impostata su True.

ScriptName

Facoltativo

Stringa

Percorso per lo script MSPL (Microsoft SIP Processing Language) utilizzato dall'applicazione (se presente). MSPL è un linguaggio di scripting utilizzato per filtrare ed eseguire il routing di messaggi SIP.

Priority

Facoltativo

Numero intero

Indica l'ordine di esecuzione delle applicazioni server. L'applicazione con priorità 0 viene avviata per prima; l'applicazione con priorità 1 per seconda e così via. Si noti che ogni servizio che ospita un'applicazione server ha il proprio gruppo di priorità. Ad esempio, il servizio di registrazione può ospitare tre applicazioni con le corrispondenti priorità 0, 1 e 2. In modo simile, il servizio Edge Server potrebbe avere 4 applicazioni con le priorità 0, 1, 2 e 3.

Se non si specifica una priorità, l'applicazione verrà aggiunta automaticamente nella parte inferiore dell'elenco delle priorità. Se si aggiunge o si rimuove un'applicazione, le priorità delle altre applicazioni verranno regolate di conseguenza. Ad esempio, se si elimina un'applicazione con priorità 0, l'applicazione che in precedenza aveva la priorità 1 avrà la priorità 0.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno. New-CsServerApplication non accetta input tramite pipeline.

Tipi restituiti

New-CsServerApplication crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Esempio

-------------------------- Esempio 1 ------------------------

New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False

Nell'Esempio 1 viene creata una nuova applicazione server con Identity EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor. Oltre a specificare l'identità (Identity), sono inclusi i parametri Uri e Critical. Questi parametri vengono utilizzati per specificare l'URI dell'applicazione e per indicare che l'applicazione non è considerata critica.

-------------------------- Esempio 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

I comandi mostrati nell'Esempio 2 dimostrano come creare una nuova applicazione server che inizialmente esiste solo in memoria. Per ottenere questo risultato, il primo comando utilizza il cmdlet New-CsServerApplication insieme a due parametri: Identity (che specifica l'identità dell'applicazione) e InMemory (che indica che la nuova applicazione deve essere creata solo in memoria). L'oggetto applicazione server risultante viene quindi memorizzato nella variabile $x.

Dopo aver creato l'applicazione server virtuale, vengono utilizzati i comandi 2 e 3 per modificare rispettivamente i valori della proprietà Uri e della proprietà Critical. Infine, il comando 4 viene utilizzato per trasformare l'applicazione server virtuale in un'applicazione server effettiva. Si noti che il comando finale è obbligatorio. Se non si utilizza il cmdlet Set-CsServerApplication, nessuna applicazione verrà configurata per EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor e l'applicazione virtuale verrà eliminata non appena si termina la sessione Windows PowerShell o si elimina la variabile $x.