Get-CsAdDomain
Dernière rubrique modifiée : 2012-03-23
Retourne des informations indiquant que services de domaine Active Directory (AD DS) a bien été configuré pour permettre l’installation de Microsoft Lync Server 2010.
Syntaxe
Get-CsAdDomain [-Domain <Fqdn>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>]
Description détaillée
Avant de pouvoir installer Lync Server 2010, votre nom de domaine doit être préparé correctement, une procédure qui comprend l’extension du schéma Active Directory pour permettre d’ajouter des attributs spécifiques à Lync Server et d’affecter les entrées requises du contrôle d’accès aux groupes universels utilisés pour gérer et exploiter Lync Server. La cmdlet Get-CsAdDomain retourne une seule valeur qui indique si Lync Server peut être installé sur votre domaine. Si Get-CsAdDomain retourne la valeur LC_DOMAINSETTINGS_STATE_READY, alors vous pouvez installer Lync Server sur ce domaine. Si la cmdlet retourne LC_DOMAINSETTINGS_STATE_NOT_READY, vous aurez besoin de préparer le domaine correctement avant d’essayer d’installer Lync Server.
Get-CsAdDomain est exécuté dans le cadre de l’assistance de l’aide à la configuration. Si l’Assistant décide que le domaine n’est pas correctement préparé, un message d’erreur est affiché et la configuration est avortée. Cependant vous pouvez exécuter Get-CsAdDomain indépendamment de l’assistant de configuration afin de vérifier le statut du domaine avant d’installer Lync Server.
Get-CsAdDomain effectue la même tâche que la commande Microsoft Office Communications Server 2007 R2 suivante :
Lcscmd.exe /domain /action:CheckDomainPrepState
Personnes autorisées à exécuter cette cmdlet : Par défaut, tout utilisateur ayant des autorisations de lecture dans Active Directory peut exécuter la cmdlet Get-CsAdDomain. Généralement, tous les membres du domaine bénéficient de cette autorisation.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdDomain"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Domain |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) du domaine à vérifier, par exemple : -Domain "litwareinc.com". Si ce paramètre n’est pas spécifié, c’est le domaine local qui est vérifié. |
DomainController |
Facultatif |
Chaîne |
Permet aux administrateurs de spécifier le nom de domaine complet du contrôleur de domaine à utiliser quand vous exécutez Get-CsAdDomain. S’il n’est pas spécifié, la cmdlet utilisera le premier contrôleur de domaine disponible. |
GlobalCatalog |
Facultatif |
Chaîne |
Nom de domaine complet (FQDN) d’un serveur de catalogue global dans votre domaine. Ce paramètre n’est pas requis si vous exécutez Get-CsAdDomain sur un ordinateur qui possède un compte sur 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 Active Directory, 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. |
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\DomainPrep.html" |
Types d’entrées
Aucun. Get-CsAdDomain n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsAdDomain retourne les instances de l’objet Microsoft.Rtc.Management.Deployment.LcDomainSettingsState.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsAdDomain
L’exemple précédent retourne des informations concernant le statut courant de votre domaine Active Directory local. Si les paramètres de votre domaine sont mis à jour et que le domaine est prêt à héberger Lync Server 2010, la valeurLC_DOMAIN_SETTINGS_STATE_READY sera renvoyée.
-------------------------- Exemple 2 --------------------------
Get-CsAdDomain -Domain "fabrikam.com"
La commande indiquée à l’exemple 2 retourne l’état actuel d’un domaine spécifique : fabrikam.com. Dans un environnement multi-domaines, vous pouvez retourner l’information pour un domaine donné en incluant le paramètre de domaine.
-------------------------- Exemple 3 --------------------------
Get-CsAdDomain -Report "C:\Logs\DomainReport.html"
L’exemple 3 récupère l’état actuel de votre domaine Active Directory et, simultanément, il enregistre les informations sur cet état dans un fichier nommé C:\Logs\DomainReport.html. Le fichier donnera le détail des démarches effectuées par Get-CsAdDomain pour déterminer l’état de disponibilité du domaine. Ces étapes incluent des tâches telles que la vérification de l’existence des groupes Active Directory et le contrôle des paramètres d’autorisation sur les différents conteneurs Active Directory.