Set-CsUserDatabaseState
Dernière rubrique modifiée : 2012-03-27
Active ou désactive une ou plusieurs bases de données utilisateur Microsoft Lync Server 2010.
Syntaxe
Set-CsUserDatabaseState -Online <$true | $false> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsUserDatabaseState -Identity <String> -Online <$true | $false> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
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 Set-CsUserDatabaseState vous permet de changer l'état d'une ou plusieurs bases de données utilisateur : vous pouvez utiliser la cmdlet pour mettre une base de données hors connexion ou pour remettre en ligne en base de données désactivée.
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 Set-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 Set-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 Set-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 "Set-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 modifié. 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. |
Online |
Obligatoire |
Booléen |
Si la valeur True ($True) est définie, rend une base de données disponible en ligne. Si la valeur False ($False) est définie, met une base de données hors connexion. |
RegistrarPool |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) du pool de serveurs d'inscriptions hébergeant les bases de données utilisateur dont l'état en ligne doit être modifié. 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. |
Force |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
||
WhatIf |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
||
Confirm |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Chaîne. Set-CsUserDatabaseState accepte une valeur de chaîne représentant l'identité de la base de données utilisateur à mettre à jour.
Types de retours
Aucun. Au lieu de cela, Set-CsUserDatabaseState modifie les instances existantes de l'objet Microsoft.Rtc.Management.Xds.UserStoreState.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com" -Online $False
La commande présentée dans l’exemple 1 met la base de données utilisateur UserDatabase:atl-sql-001.litwareinc.com hors connexion. Cette opération s’effectue en définissant la valeur $False pour la propriété Online.
-------------------------- Exemple 2 ------------------------
Set-CsUserDatabaseState -RegistrarPool atl-cs-001.litwareinc.com -Online $False
Dans l’exemple 2, toutes les bases de données utilisateur du pool de serveurs d’inscriptions atl-cs-001.litwareinc.com sont mises hors connexion.
-------------------------- Exemple 3 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $False} | ForEach-Object {Set-CsUserDatabaseState -Identity $_.Identity -Online $True}
Dans l’exemple précédent, le système recherche toutes les bases de données utilisateur actuellement hors connexion, puis les remet en ligne. Pour ce faire, la commande appelle d'abord Get-CsUserDatabaseState sans aucun paramètre, afin de retourner une collection de toutes les bases de données utilisateur de 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 à False. La collection filtrée est alors redirigée vers la cmdlet ForEach-Object, qui extrait chaque base de données présente dans la collection et définit la propriété Online sur True. Veuillez noter que la collection de bases de données hors ligne doit être acheminée vers ForEach-Object plutôt que vers Set-CsUserDatabaseState. La raison en est que la seconde cmdlet n'accepte pas les informations acheminées directement.