Condividi tramite

  • Articolo

Set-CsServerApplication

 

Ultima modifica dell'argomento: 2012-03-26

Modifica i valori delle proprietà di un'applicazione server esistente. Le applicazioni server sono applicazioni ospitate da Microsoft Lync Server 2010.

Sintassi

Set-CsServerApplication [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Set-CsServerApplication [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Priority <Int32>] [-ScriptName <String>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le applicazioni server fanno riferimento a singoli programmi eseguiti in Lync Server 2010. Il cmdlet Set-CsServerApplication consente agli amministratori di modificare i valori delle proprietà di qualsiasi applicazione eseguita come parte di Lync Server.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsServerApplication i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per il server applicazioni da modificare. Le identità delle applicazioni server sono composte dal servizio in cui è ospitata l'applicazione seguito dal nome dell'applicazione. Ad esempio, il server applicazioni denominato QoEAgent può avere un'identità analoga alla seguente: Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Instance

Facoltativo

Oggetto ServerApplication.Application

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

Critical

Facoltativo

Booleano

Se impostato su True (valore predefinito), Lync Server non verrà avviato se non è possibile avviare l'applicazione in questione. Se False, Lync Server verrà inviato indipendentemente dal fatto che sia possibile avviare l'applicazione o meno.

Enabled

Facoltativo

Booleano

Impostare questo valore su True per abilitare l'applicazione. Impostare questo valore su False per disabilitare l'applicazione.

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. Ogni servizio che ospita un'applicazione server presenta il proprio set univoco di priorità. Il servizio di registrazione ad esempio può ospitare tre applicazioni con priorità corrispondenti pari a 0, 1 e 2. Analogamente, il servizio Edge Server può disporre di 4 applicazioni con le priorità 0, 1, 2 e 3.

Se non si specifica una priorità, l'applicazione verrà automaticamente aggiunta al fondo dell'elenco delle priorità. Se si aggiunge o rimuove un'applicazione, le priorità delle altre applicazioni verranno modificate di conseguenza. Se ad esempio si elimina un'applicazione con priorità 0, per l'applicazione che precedentemente presentava la priorità 1 verrà automaticamente impostata la priorità 0.

ScriptName

Facoltativo

Stringa

Percorso dello script MSPL (Microsoft SIP Processing Language) utilizzato dall'applicazione. MSPL è un linguaggio di scripting utilizzato per filtrare e instradare i messaggi SIP.

Uri

Facoltativo

Stringa

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

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.

Confirm

Facoltativo

Parametro opzionale

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

WhatIf

Facoltativo

Parametro opzionale

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

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Set-CsServerApplication accetta le istanze da pipeline dell'oggetto applicazione server.

Tipi restituiti

Set-CsServerApplication non restituisce un valore o un oggetto. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.application.

Esempio

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

Set-CsServerApplication -Identity "Registrar:atl-cs-001.litwareinc.com/ExumRouting" -Enabled $True

Il comando illustrato nell'esempio 1 abilita l'applicazione server che presenta l'identità Registrar:atl-cs-001.litwareinc.com/ExumRouting. Poiché le identità devono essere univoche, il comando abiliterà una singola applicazione server.

-------------------------- Esempio 2 ------------------------

Get-CsServerApplication | Where-Object {$_.Enabled -eq $False} | Set-CsServerApplication -Enabled $True

Il comando precedente abilita tutte le applicazioni server attualmente disabilitate. A tale scopo, nel comando viene chiamato innanzitutto Get-CsServerApplication per restituire una raccolta di tutte le applicazioni server attualmente in uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona unicamente le applicazioni con proprietà Enabled uguale a False. La raccolta filtrata viene a sua volta inviata tramite pipe a Set-CsServerApplication, che utilizza ogni elemento della raccolta e imposta la proprietà Enabled su True.