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.
Vedere anche
Ulteriori risorse
Get-CsServerApplication
New-CsServerApplication
Set-CsServerApplication