Partager via

  • Article

Get-CsServerApplication

 

Dernière rubrique modifiée : 2012-03-23

Retourne des informations sur les applications serveur utilisées dans votre organisation. Les applications serveur sont des applications hébergées par Microsoft Lync Server 2010.

Syntaxe

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

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

Description détaillée

Les applications serveur font référence aux programmes individuels exécutés sous Lync Server 2010. La cmdlet Get-CsServerApplication offre un moyen aux administrateurs de retourner des informations sur l’une des applications (ou toutes) exécutées dans le cadre de Lync Server.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsServerApplication : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de l’application serveur à récupérer. Les identités de l’application serveur se composent du service où l’application est hébergée et du nom de l’application. Par exemple, l’application serveur appelée QoEAgent peut comporter une identité similaire à celle-ci : service: Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Pour récupérer une collection de toutes les applications s’exécutant sur un service donné, supprimez simplement le nom de l’application :

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

Si ce paramètre est omis, toutes les applications serveur seront alors retournées lors de l’appel de Get-CsServerApplication.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques pour retourner l’application serveur ou un ensemble d’applications serveur. Par exemple, pour retourner toutes les applications serveur comportant la valeur de chaîne « IIMFilter » dans leur identité, utilisez la syntaxe suivante : -Filter "*IIMFilter*".

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données d’application serveur à partir du réplica local du magasin central de gestion et non du magasin central de gestion lui-même.

Types d’entrées

Aucun. Get-CsServerApplication n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsServerApplication renvoie des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Exemple

-------------------------- Exemple 1 ------------------------

Get-CsServerApplication

La commande illustrée dans l’exemple 1 retourne des informations sur toutes les applications serveur actuellement utilisées dans l’organisation. Pour ce faire, appelez Get-CsServerApplication sans aucun paramètre.

-------------------------- Exemple 2 ------------------------

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

Dans l’exemple 2, les informations sont retournées pour toutes les applications serveur s’exécutant sur le service EdgeServer:atl-edge-001.litwareinc.com.

-------------------------- Exemple 3 ------------------------

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

L’exemple 3 retourne des informations pour une seule application serveur : celle dont l’identité est Registrar:atl-cs-001.litwareinc.com/ExumRouting.

-------------------------- Exemple 4 ------------------------

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

La commande ci-dessus retourne toutes les applications serveur configurées pour une utilisation dans le pool atl-cs-001.litwareinc.com. Pour ce faire, utilisez le paramètre Filter et la valeur de filtre « service:*:atl-cs-001.litwareinc.com* ». La valeur de filtre limite les valeurs renvoyées aux applications dont l’identité commence par la chaîne « service: » et inclut les caractères « :atl-cs-001.litwareinc.com ».

-------------------------- Exemple 5 ------------------------

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

Dans l’exemple 5, les informations sont retournées pour toutes les applications serveur actuellement désactivées. Pour effectuer cette tâche, la commande appelle d’abord Get-CsServerApplication pour retourner une collection de toutes les applications serveur configurées pour être utilisées dans l’organisation. Cette collection est alors redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les applications dont la propriété Enabled est égale à False.

-------------------------- Exemple 6 ------------------------

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

L’exemple 6 est une variante de la commande illustrée dans l’exemple 5. Dans l’exemple 6, les informations sont retournées pour toutes les applications serveur marquées comme critiques et actuellement désactivées. Pour ce faire, la commande appelle d’abord Get-CsServerApplication sans aucun paramètre ; elle retourne une collection de toutes les applications serveur configurées pour être utilisées. Cette collection est ensuite redirigée vers Where-Object, qui sélectionne uniquement les applications qui répondent à deux critères : la propriété Critical doit être égale à True et la propriété Enabled doit être égale à False. L’opérateur -and garantit que seuls les objets répondant aux deux critères seront retournés.

-------------------------- Exemple 7 ------------------------

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

Dans l’exemple 7, les informations sont retournées pour toute application serveur comportant la valeur de chaîne « routing » dans son URI. Cette tâche est effectuée en utilisant d’abord Get-CsServerApplication pour récupérer toutes les applications serveur actuellement utilisés. La collection obtenue est ensuite redirigée vers Where-Object, qui sélectionne uniquement les applications dans lesquelles la propriété Uri inclut la valeur de chaîne « routing ».

-------------------------- Exemple 8 ------------------------

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

La commande ci-dessus retourne les informations de toutes les applications serveur assignées à un script. Pour ce faire, la commande récupère d’abord une collection de toutes les applications serveur actuellement utilisées. Ces informations sont récupérées en appelant Get-CsServerApplication sans paramètres. Cette collection complète d’applications serveur est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les applications pour lesquelles la propriété ScriptName est différente d’une valeur Null. Si la propriété ScriptName est différente d’une valeur Null, cela signifie qu’un script a été assigné à cette application.