Condividi tramite

  • Articolo

Get-CsServerApplication

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle applicazioni server in uso nell'organizzazione. Le applicazioni server sono applicazioni ospitate da Microsoft Lync Server 2010.

Sintassi

Get-CsServerApplication [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsServerApplication [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Le applicazioni server fanno riferimento a singoli programmi che vengono eseguiti in Lync Server 2010. Il cmdlet Get-CsServerApplication offre agli amministratori un mezzo per restituire informazioni su una o su tutte le applicazioni in esecuzione come parte di Lync Server.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsServerApplication in locale: RTCUniversalUserAdmins, 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 "Get-CsServerApplication"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Un identificatore univoco per l'applicazione server da recuperare. 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.

Per recuperare una raccolta di tutte le applicazioni in esecuzione su un determinato servizio è sufficiente tralasciare il nome dell'applicazione:

-Identity "Registrar:atl-cs-001.litwareinc.com "

Se questo parametro viene omesso, la chiamata a Get-CsServerApplication consente di restituire tutte le applicazioni server.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly durante la restituzione di un'applicazione server o di un set di applicazioni server. Ad esempio, per restituire tutte le applicazioni server che contengono il valore stringa "IIMFilter" in Identity, utilizzare questa sintassi: -Filter "*IIMFilter*".

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati delle applicazioni server dalla replica locale del archivio di gestione centrale anziché dal archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsServerApplication non accetta l'input da pipeline.

Tipi restituiti

Get-CsServerApplication restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Esempio

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

Get-CsServerApplication

Con il comando mostrato nell'esempio 1 vengono restituite le informazioni su tutte le applicazioni server attualmente in uso nell'organizzazione. Questo risultato viene ottenuto chiamando Get-CsServerApplication senza alcun parametro.

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

Get-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com"

Con l'esempio 2 vengono restituite le informazioni per tutte le applicazioni server in esecuzione sul servizio EdgeServer:atl-edge-001.litwareinc.com.

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

Get-CsServerApplication -Identity "service:Registrar:atl-cs-001.litwareinc.com/ExumRouting"

Con l'esempio 3 vengono restituite le informazioni per una singola applicazione server, l'applicazione con identità "Registrar:atl-cs-001.litwareinc.com/ExumRouting".

-------------------------- Esempio 4 ------------------------

Get-CsServerApplication -Filter "service:*:atl-cs-001.litwareinc.com*"

Con il comando precedente vengono restituite tutte le applicazioni server configurate per l'uso nel pool atl-cs-001.litwareinc.com. Questa operazione viene eseguita con il parametro Filter e il valore di filtro "service:*:atl-cs-001.litwareinc.com*". Il valore del filtro limita i dati restituiti alle applicazioni con un'identità che inizia con i caratteri "service:" e che include i caratteri ":atl-cs-001.litwareinc.com".

-------------------------- Example 5 ------------------------

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

Con l'esempio 5 vengono restituite le informazioni per tutte le applicazioni server attualmente disabilitate. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsServerApplication per restituire una raccolta di tutte le applicazioni server configurate per l'uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona solo le applicazioni in cui la proprietà Enabled equivale a False.

-------------------------- Example 6 ------------------------

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

L'esempio 6 rappresenta una variazione del comando mostrato nell'esempio 5. Con l'esempio 6 vengono restituite le informazioni per tutte le applicazioni server contrassegnate come critiche e attualmente disabilitate. Per ottenere tale risultato, il comando chiama per prima cosa Get-CsServerApplication senza parametri per restituire una raccolta di tutte le applicazioni server configurate per l'uso. La raccolta viene quindi inviata tramite pipe a Where-Object, che sceglie solo le applicazioni che soddisfano due criteri: la proprietà Critical deve essere uguale a True e, allo stesso modo, la proprietà Enabled deve essere uguale a False. L'operatore -and garantisce la restituzione dei soli oggetti che soddisfano entrambi i criteri.

-------------------------- Example 7 ------------------------

Get-CsServerApplication | Where-Object {$_.Uri -like "*routing*"}

Con l'esempio 7 vengono restituite le informazioni per tutte le applicazioni server che contengono il valore stringa "routing" nel loro URI. Questa operazione viene eseguita utilizzando Get-CsServerApplication per recuperare tutte le applicazioni server attualmente in uso. La raccolta risultante viene quindi inviata tramite pipe a Where-Object, che seleziona solo le applicazioni in cui la proprietà Uri contiene il valore stringa "routing".

-------------------------- Example 8 ------------------------

Get-CsServerApplication | Where-Object {$_.ScriptName -ne $Null}

Con il comando precedente vengono restituite informazioni per tutte le applicazioni server a cui è stato assegnato uno script. Per ottenere tale risultato, il comando recupera per prima cosa una raccolta di tutte le applicazioni server attualmente in uso per mezzo di una chiamata a Get-CsServerApplication senza parametri. La raccolta completa delle applicazioni server viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le applicazioni in cui la proprietà ScriptName non è uguale a un valore null. Se la proprietà ScriptName non è uguale a un valore null significa che è stato assegnato uno script a tale applicazione.