Condividi tramite

  • Articolo

Remove-CsServerApplication

 

Ultima modifica dell'argomento: 2012-03-27

Rimuove un'applicazione server esistente. Le applicazioni server sono applicazioni ospitate da Microsoft Lync Server 2010.

Sintassi

Remove-CsServerApplication -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le applicazioni server fanno riferimento a singoli programmi che vengono eseguiti in Lync Server 2010. Il cmdlet Remove-CsServerApplication offre agli amministratori un mezzo per rimuovere qualsiasi applicazione in esecuzione come parte di Lync Server. L'eliminazione di un'applicazione server non equivale alla disinstallazione dell'applicazione. Quando si esegue Remove-CsServerApplication, l'applicazione non viene più eseguita in Lync Server. Tuttavia, il software non viene disinstallato e l'applicazione può essere riabilitata eseguendo il cmdlet New-CsServerApplication.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsServerApplication in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Un identificatore univoco per l'applicazione server da rimuovere. 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: service:Registrar:atl-cs-001.litwareinc.com/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.

WhatIf

Facoltativo

Parametro opzionale

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

Confirm

Facoltativo

Parametro opzionale

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

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Remove-CsServerApplication consente di accettare le istanze da pipeline dell'oggetto applicazione server.

Tipi restituiti

Remove-CsServerApplication consente di eliminare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Esempio

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

Remove-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor"

Con l'esempio 1 viene rimossa l'applicazione server con identità service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor Poiché le identità devono essere univoche, il comando non eliminerà mai più di una applicazione.

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

Get-CsServerApplication | Where-Object {$_.Critical -eq $False} | Remove-CsServerApplication

Con l'esempio 2 vengono rimosse tutte le applicazioni server non critiche. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsServerApplication per restituire una raccolta di tutte le applicazioni server attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo le applicazioni in cui la proprietà Critical equivale a False. Tale raccolta filtrata viene quindi inviata tramite pipe a Remove-CsServerApplication, che elimina ciascun elemento nella raccolta.

-------------------------- Esempio 3 ------------------------

Get-CsServerApplication -Filter "service:EdgeServer:atl-cs-001.litwareinc.com/*" | Remove-CsServerApplication

Con il comando precedente vengono eliminate tutte le applicazioni server configurate per l'uso dal servizio EdgeServer:atl-cs-001.litwareinc.com. Per eseguire questa operazione viene utilizzato Get-CsServerApplication con il parametro Filter; il valore del filtro "service:EdgeServer:atl-cs-001.litwareinc.com/*" restituisce tutte le applicazioni la cui identità inizia con i caratteri "service:EdgeServer:atl-cs-001.litwareinc.com/". A sua volta, la raccolta viene inviata tramite pipe a Remove-CsServerApplication, che elimina ogni applicazione da EdgeServer:atl-cs-001.litwareinc.com.