Install-CsDatabase
Dernière rubrique modifiée : 2012-03-23
Installe une ou plusieurs bases de données Microsoft Lync Server 2010.
Syntaxe
Install-CsDatabase -LocalDatabases <SwitchParameter> [-Clean <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-Force <SwitchParameter>] [-ForDefaultInstance <SwitchParameter>] [-ForInstance <String>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Install-CsDatabase -CentralManagementDatabase <SwitchParameter> -SqlServerFqdn <Fqdn> [-Clean <SwitchParameter>] [-Collocated <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-SqlInstanceName <String>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Install-CsDatabase -ConfiguredDatabases <SwitchParameter> -SqlServerFqdn <Fqdn> [-Clean <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-ExcludeCollocatedStores <SwitchParameter>] [-Force <SwitchParameter>] [-ForDefaultInstance <SwitchParameter>] [-ForInstance <String>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Install-CsDatabase -DatabaseType <Application | Archiving | Monitoring | User | Provision> -SqlServerFqdn <Fqdn> [-Clean <SwitchParameter>] [-Collocated <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DatabasePaths <String[]>] [-Force <SwitchParameter>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-SkipPrepareCheck <SwitchParameter>] [-SqlInstanceName <String>] [-Update <SwitchParameter>] [-UseDefaultSqlPaths <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Du magasin central de gestion à la base de données d’archivage, Lync Server 2010 a très largement recours aux bases de données SQL Server. En règle générale, ces bases de données sont configurées en même temps que vous installez Lync Server 2010 ou bien un rôle Lync Server 2010 (par exemple, le serveur de surveillance) nécessitant une base de données principale. Après installation, ces bases de données n’exigent pas habituellement que vous les réinstalliez ou les déplaciez vers de nouveaux emplacements.
Néanmoins, dans des circonstances exceptionnelles, vous devrez peut-être installer manuellement une base de données Lync Server 2010 ; cela peut s’avérer nécessaire si vous devez déplacer une base de données vers un autre serveur ou si le programme d’installation n’est pas parvenu à installer la base de données pour vous. La cmdlet Install-CsDatabase vous permet d’installer toutes les bases de données SQL Server utilisées par Lync Server 2010.
Lorsque vous exécutez la cmdlet Install-CsDatabase, il existe trois manières fondamentales de gérer la configuration de la base de données que vous installez :
Option 1 : Exécutez la cmdlet sans inclure de paramètre spécifiant les chemins d’accès à la base de données. Lorsque vous exécutez la cmdlet Install-CsDatabase sans le paramètre DatabasePath ou le paramètre UseDefaultSqlPaths, celle-ci applique un algorithme intégré pour choisir l’emplacement de stockage des journaux de base de données et des fichiers de données. Notez que cet algorithme intégré fonctionne avec un serveur SQL Server autonome. Il ne fonctionne pas avec un cluster SQL Server. Pour l’installation d’une base de données sur un cluster SQL Server, votre commande doit inclure soit le paramètre DatabasePath, soit le paramètre UseDefaultSqlPaths.
Option 2 : Exécutez la cmdlet avec le paramètre DatabasePath. Lorsque vous exécutez la cmdlet Install-CsDatabase avec le paramètre DatabasePath, l’algorithme intégré n’est pas utilisé pour choisir l’emplacement de stockage des journaux de base de données et des fichiers de données. À la place, les administrateurs peuvent sélectionner l’emplacement de ces journaux et de ces fichiers de données. Pour installer à la fois les fichiers de données et les journaux SQL Server au même emplacement, précisez simplement le chemin d’accès au dossier dans lequel ces données sont à stocker. Par exemple :
-DatabasePath C:\SqlData
Pour stocker les fichiers de données à un emplacement et les fichiers journaux à un autre, spécifiez le chemin d’accès à chaque fichier, en séparant les deux emplacements par une virgule (prenez soin de ne pas insérer un espace vide avant ou après la virgule) :
-DatabasePath C:\SqlLogs,D:\SqlData
Les fichiers journaux seront toujours stockés dans le premier emplacement spécifié tandis que les fichiers de données seront stockés dans le deuxième emplacement.
Dans un serveur principal du pool, certains fichiers journaux peuvent être stockés de manière autonome sur un lecteur. Si vous disposez d’un serveur principal de pool équipé d’un seul lecteur, les fichiers seront distribués comme suit :
Lecteur 1 – journal Rtcdyn ; journal Rtc ; autres journaux ; autres données.
Si vous êtes muni de deux lecteurs, les fichiers seront distribués ainsi :
Lecteur 1 – journal Rtcdyn ; journal Rtc.
Lecteur 2 – autres journaux ; autres données.
Avec trois lecteurs :
Lecteur 1 – journal Rtcdyn.
Lecteur 2 – journal Rtc.
Lecteur 3 – autres journaux ; autres données.
Et avec quatre lecteurs :
Lecteur 1 – journal Rtcdyn.
Lecteur 2 – journal Rtc.
Lecteur 3 – autres journaux.
Lecteur 4 – autres données.
Pour plus d’informations et de détails sur d’autres scénarios d’installation, consultez le guide de déploiement de Lync Server 2010 Enterprise Edition.
Option 3 : Exécutez la cmdlet avec le paramètre UseDefaultSqlPaths. Lorsque vous exécutez la cmdlet Install-CsDatabase avec le paramètre UseDefaultSqlPaths, l’algorithme intégré n’est pas utilisé pour choisir l’emplacement de stockage des journaux de base de données et des fichiers de données. À la place, les fichiers journaux et les fichiers de données sont stockés aux emplacements spécifiés dans les chemins d’accès SQL Server par défaut (ces chemins doivent être configurés à l’avance par un administrateur SQL). Les fichiers de données seront stockés à l’emplacement attribué par défaut pour les fichiers de données SQL Server et les fichiers journaux SQL Server à leur emplacement défini par défaut.
Avant d’exécuter la cmdlet Install-CsDatabase, vous devez vous assurer que le groupe RTCUniversalServerAdmins n’a pas été désigné en tant que propriétaire de la base de données. Si ce groupe apparaît comme propriétaire, il est possible qu’il soit supprimé lorsque vous appelez la cmdlet Install-CsDatabase.
Personnes autorisées à exécuter cette cmdlet : Vous devez être un membre du domaine, un membre du groupe RTCUniversalReadOnlyAdmins, un administrateur SQL Server et un administrateur local sur l’ordinateur où SQL Server est installé pour exécuter localement la cmdlet Install-CsDatabase. 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 "Install-CsDatabase"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
CentralManagementDatabase |
Facultatif |
Paramètre de commutateur |
Si ce paramètre est inclus, Install-CsDatabase utilise le paramètre SqlServerFqdn pour installer le magasin central de gestion sur l’ordinateur spécifié. Ce paramètre est généralement utilisé uniquement par l’Générateur de topologies et n’est habituellement appelé qu’une seule fois, au moment de la configuration initiale. |
Clean |
Facultatif |
Paramètre de commutateur |
Si ce paramètre est inclus, Install-CsDatabase supprime et réinstalle les bases de données selon les besoins. S’il n’est pas inclus, Install-CsDatabase n’écrasera pas les bases de données existantes. Vous ne pouvez pas utiliser les paramètres Clean et Update dans la même commande. |
Collocated |
Facultatif |
Paramètre de commutateur |
Si ce paramètre est présent, des rôles de base de données supplémentaires seront colocalisés avec le magasin central de gestion. |
ConfiguredDatabases |
Facultatif |
Paramètre de commutateur |
Lit les informations de la topologie Lync Server 2010 et installe les bases de données requises sur l’ordinateur SQL Server ou le cluster SQL Server spécifié. Les administrateurs qui ont besoin de la cmdlet Install-CsDatabase utiliseront presque toujours ce paramètre pour spécifier les bases de données à installer. |
DatabasePaths |
Facultatif |
Chaîne |
Spécifie les lecteurs et les dossiers où les données et les fichiers journaux peuvent être stockés. Par exemple : -DatabasePaths "D:\Logs","E:\Data". |
DatabaseType |
Facultatif |
Chaîne |
Permet d’installer une base de données spécifique sur un ordinateur SQL Server ou un cluster SQL Server spécifique. Sauf instruction contraire du personnel du support technique de Microsoft, les administrateurs n’ont généralement pas besoin d’exécuter la cmdlet Install-CsDatabase avec le paramètre DatabaseType. Ils doivent utiliser à la place le paramètre ConfiguredDatabases. Le paramètre DatabaseType nécessite que vous connaissiez le type exact et l’emplacement de chaque base de données utilisée dans votre topologie. Il est uniquement requis si l’exécution de la commande Install-CsDatabase à l’aide du paramètre ConfiguredDatabases se solde par un échec. Les valeurs valides pour DatabaseType sont les suivantes : Application Archiving Monitoring Provision User |
ExcludeCollocatedStores |
Facultatif |
Paramètre de commutateur |
Si ce paramètre est présent, il supprime un message d’avertissement vous indiquant que les magasins de bases de données colocalisées doivent être installés sur l’ordinateur local. |
ForDefaultInstance |
Facultatif |
Paramètre de commutateur |
Lorsqu’il est spécifié, ce paramètre indique à Install-CsDatabase d’agir uniquement par rapport à l’instance SQL Server par défaut. Vous ne pouvez pas utiliser les paramètres ForDefaultInstance et ForInstance dans la même commande. |
ForInstance |
Facultatif |
Chaîne |
Lorsqu’il est spécifié, ce paramètre indique à Install-CsDatabase d’agir uniquement par rapport à l’instance SQL Server spécifiée. Vous ne pouvez pas utiliser les paramètres ForInstance et ForDefaultInstance dans la même commande. |
GlobalCatalog |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) d’un serveur de catalogue global dans votre domaine. Ce paramètre n’est pas obligatoire si vous exécutez Install-CsDatabase sur un ordinateur avec un compte dans votre domaine. |
GlobalSettingsDomainController |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) d’un contrôleur de domaine dans lequel les paramètres globaux sont stockés. Si les paramètres globaux sont stockés dans le conteneur Système dans services de domaine Active Directory (AD DS), ce paramètre doit pointer sur le contrôleur de domaine racine. Si les paramètres globaux sont stockés dans le conteneur de configuration, tout contrôleur de domaine peut être utilisé et ce paramètre peut être omis. |
LocalDatabases |
Facultatif |
Paramètre de commutateur |
Si ce paramètre est inclus, Install-CsDatabase étudie la topologie de Lync Server 2010 et installe, selon les besoins, des bases de données et des magasins sur l’ordinateur local. |
SkipPrepareCheck |
Facultatif |
Paramètre de commutateur |
S’il est présent, ce paramètre indique à Install-CsDatabase de passer outre les vérifications de préparation de départ. |
SqlInstanceName |
Facultatif |
Chaîne |
Nom de l’instance de base de données où cette dernière doit être installée. Une instance de base de données est simplement un ensemble de processus exécutés qui fournit un accès à des fichiers de base de données. Si ce paramètre est omis, Install-CsDatabase utilisera l’instance SQL Server par défaut. |
SqlServerFqdn |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) de l’ordinateur où la base de données doit être installée. Par exemple : -SqlServerFqdn atl-sql-001.litwareinc.com. |
Update |
Facultatif |
Paramètre de commutateur |
S’il est présent, il met à jour la base de données existante. Vous ne pouvez pas utiliser les paramètres Update et Clean dans la même commande. |
UseDefaultSqlPaths |
Facultatif |
Paramètre de commutateur |
Lorsqu’il est spécifié, ce paramètre demande à SQL Server de sélectionner le lecteur dans lequel les données et les fichiers journaux seront stockés. |
Force |
Facultatif |
Paramètre de commutateur |
S’il est présent, ce paramètre force l’installation de la nouvelle base de données, même si une base de données existante de ce type est actuellement utilisée. |
Report |
Facultatif |
Chaîne |
Permet de spécifier un chemin d’accès au fichier journal créé lors de l’exécution de la cmdlet. Par exemple : -Report "C:\Logs\InstallDatabases.html" |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Aucun. Install-CsDatabase n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Install-CsDatabase ne retourne ni valeur ni objet.
Exemple
-------------------------- Exemple 1 ------------------------
Install-CsDatabase -ConfiguredDatabases -SqlServerFqdn atl-sql-001.litwareinc.com -DatabasePaths "E:\CSLog","F:\CSLog","G:\CSDB"
Dans l’exemple 1, Install-CsDatabase étudie la topologie Lync Server 2010, puis installe toutes les bases de données requises dans le pool atl-sql-001.litwareinc.com.
-------------------------- Exemple 2 ------------------------
Install-CSDatabase -CentralManagementDatabase -SqlServerFqdn atl-sql-001.litwareinc.com -SqlInstanceName rtc -DatabasePaths "G:\CSDB"
La commande présentée dans l’exemple 2 installe le magasin central de gestion dans le pool atl-sql-001.litwareinc.com. La base de données sera installée dans l’instance rtc et utilisera le dossier G:\CSDB.