Get-CsUserDatabaseState
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur l’état en ligne (True ou False) d’une ou plusieurs bases de données utilisateur Microsoft Lync Server 2010.
Syntaxe
Get-CsUserDatabaseState [-Identity <String>]
Get-CsUserDatabaseState [-RegistrarPool <Fqdn>]
Description détaillée
Lync Server 2010 a recours à la base de données utilisateur (également appelée magasin d'utilisateurs) afin de gérer les informations de présence et de routage pour les utilisateurs de Lync Server. La cmdlet Get-CsUserDatabaseState permet de connaître l'état en cours (en ligne ou hors connexion) de toute base de données utilisateur actuellement utilisée dans votre organisation.
Notez que, par défaut, les exceptions du pare-feu pour SQL Server Express ne sont pas activées quand vous installez l'édition standard de Lync Server 2010. Cela signifie en l'occurrence que vous ne pourrez pas exécuter Get-CsUserDatabaseState à partir d'une instance distante de Windows PowerShell. C'est parce que votre commande sera incapable de traverser le pare-feu et d'accéder à la base de de données SQL Server Express. Vous pouvez exécuter la cmdlet en local (c'est-à-dire sur le serveur Standard Edition lui-même.) Toutefois, pour exécuter Get-CsUserDatabaseState à distance, vous allez devoir activer manuellement les exceptions du pare-feu pour SQL Server Express.
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-CsUserDatabaseState : 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-CsUserDatabaseState"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Identifiant unique de la base de données utilisateur dont l’état en ligne doit être retourné. Par exemple : -Identity "UserDatabase:atl-sql-001.litwareinc.com". Vous ne pouvez pas utiliser Identity et RegistrarPool dans la même commande, ni utiliser des caractères génériques avec un paramètre. Si les deux paramètres sont omis, Get-CsUserDatabaseState retourne des informations sur toutes les bases de données utilisateur actuellement utilisées. |
RegistrarPool |
Facultatif |
Chaîne |
Nom de domaine complet du pool de serveurs d’inscriptions hébergeant les bases de données utilisateur dont l’état en ligne doit être retourné. Par exemple : -RegistrarPool "atl-cs-001.litwareinc.com". Vous ne pouvez pas utiliser Identity et RegistrarPool dans la même commande, ni utiliser des caractères génériques avec un paramètre. Si les deux paramètres sont omis, Get-CsUserDatabaseState retourne des informations sur toutes les bases de données utilisateur actuellement utilisées. |
Types d’entrées
Aucun. Get-CsUserDatabaseState n'accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsUserDatabaseState retourne les instances de l'objet Microsoft.Rtc.Management.Xds.UserStoreState.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsUserDatabaseState
La commande présentée dans l’exemple 1 retourne l’état en ligne de chaque base de données utilisateur configurée pour être utilisée dans l’organisation.
-------------------------- Exemple 2 ------------------------
Get-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com"
La commande présentée dans l’exemple 2 retourne l’état en ligne d’une seule base de données utilisateur : la base de données dont l’identité est UserDatabase:atl-sql-001.litwareinc.com.
-------------------------- Exemple 3 ------------------------
Get-CsUserDatabaseState -RegistrarPool "atl-cs-001.litwareinc.com"
Dans l'exemple 3, les informations d'état sont retournées pour toutes les bases de données utilisateur situées dans le pool de serveurs d'inscriptions atl-cs-001.litwareinc.com.
-------------------------- Exemple 4 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $True}
Dans l’exemple précédent, les informations sont retournées pour toutes les bases de données utilisateur qui sont actuellement en ligne. Pour ce faire, la commande appelle d'abord Get-CsUserDatabaseState sans aucun paramètre. Elle retourne une collection de toutes les bases de données utilisateurs utilisées dans l'organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui choisit uniquement les bases de données pour lesquelles la propriété Online est égale à True.