Get-CsAdForest

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zurück, die angeben, ob die Konfiguration der Active Directory-Gesamtstruktur die Installation von Microsoft Lync Server 2010 zulässt.

Syntax

Get-CsAdForest [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>] [-RootDomainController <Fqdn>] [-SkipPrepareCheck <$true | $false>]

Detaillierte Beschreibung

Vor der Installation von Lync Server 2010 müssen Sie verschiedene Änderungen auf Gesamtstrukturebene an Active Directory-Domänendienste (AD DS) vornehmen. Dazu gehören das Erstellen von Lync Server-spezifischen Anzeigespezifizierern und Objekten, das Erstellen universeller Sicherheitsgruppen zur Verwaltung von Lync Server sowie das Gewähren von Zugriffsberechtigungen für globale Einstellungsobjekte für diese Gruppen. Das Cmdlet Get-CsAdForest gibt einen einzelnen Wert zurück, der Sie informiert, ob Lync Server in einer Gesamtstruktur installiert werden kann. Wenn Get-CsAdForest den Wert "LC_FORESTSETTINGS_STATE_READY" zurückgibt, können Sie Lync Server in der Gesamtstruktur installieren. Wenn das Cmdlet "LC_FORESTSETTINGS_STATE_NOT_READY" zurückgibt, müssen Sie die Gesamtstruktur zunächst ordnungsgemäß vorbereiten, bevor Sie Lync Server installieren.

Get-CsAdForest wird im Rahmen des Setup-Assistenten ausgeführt. Wenn dieser feststellt, dass die Gesamtstruktur nicht ordnungsgemäß vorbereitet ist, wird eine Fehlermeldung eingeblendet und der Setupvorgang abgebrochen. Sie können Get-CsAdForest aber auch unabhängig vom Setup-Assistenten ausführen, um den Status der Gesamtstruktur zu überprüfen, bevor Sie versuchen, Lync Server zu installieren.

Get-CsAdForest hat dieselbe Funktion wie der folgende Microsoft Office Communications Server 2007 R2-Befehl:

Lcscmd.exe /forest /action:CheckForestPrepState

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig kann jeder Benutzer mit Leseberechtigung für Active Directory das Cmdlet Get-CsAdForest lokal ausführen. Üblicherweise besitzen alle Domänenmitglieder diese Berechtigung.

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

Parameter

Parameter	Erforderlich	Typ	Beschreibung
GlobalCatalog	Optional	Zeichenfolge	Vollqualifizierter Domänenname (FQDN) eines globalen Katalogservers in Ihrer Domäne. Dieser Parameter ist nicht erforderlich, wenn Get-CsAdForest auf einem Computer ausgeführt wird, für den ein Konto in der Domäne vorhanden ist.
GlobalSettingsDomainController	Optional	Zeichenfolge	FQDN eines Domänencontrollers, auf dem die globalen Einstellungen gespeichert sind. Wenn die globalen Einstellungen im Systemcontainer in AD DS gespeichert sind, muss dieser Parameter auf den Stammdomänencontroller verweisen. Wenn die globalen Einstellungen im Konfigurationscontainer gespeichert sind, kann jeder Domänencontroller verwendet werden, und dieser Parameter kann ausgelassen werden.
RootDomainController	Optional	Zeichenfolge	FQDN des Stammdomänencontrollers, der zum Erstellen von Vertrauenspfaden für Clients dient, die auf Ressourcen in Domänen außerhalb der eigenen Domäne zugreifen müssen.
Report	Optional	Zeichenfolge	Ermöglicht es Ihnen, einen Dateipfad für die bei der Ausführung des Cmdlets erstellte Protokolldatei anzugeben. Beispiel: -Report "C:\Logs\ForestPrep.html"
SkipPrepareCheck	Optional	Boolescher Wert	Wenn "True" ($True) festgelegt ist, werden die einleitenden Vorbereitungsprüfungen von "Get-CsAdForest" übersprungen.

Eingabetypen

Keine.

Rückgabetypen

Mit Get-CsAdForest werden Instanzen des Objekts "Microsoft.Rtc.Management.Deployment.LcForestSettingsState" zurückgegeben.

Beispiel

-------------------------- Beispiel 1 --------------------------

Get-CsAdForest

Im vorstehenden Beispiel werden Informationen zurückgegeben, die angeben, ob die Konfiguration der Active Directory-Gesamtstruktur die Installation von Lync Server zulässt.

-------------------------- Beispiel 2 --------------------------

Get-CsAdForest -Report C:\Logs\ForestState.html

In Beispiel 2 werden Informationen über den Status der Gesamtstruktur zurückgegeben, und die Bereitschaft der Gesamtstruktur wird auf dem Bildschirm angezeigt. Zusätzlich werden detaillierte Informationen über die Schritte, die zum Ermitteln des Gesamtstrukturzustands unternommen werden, in eine Datei namens "C:\Logs\ForestState.html" geschrieben. Diese Datei umfasst unter anderem eine detaillierte Liste der Active Directory-Gruppen und -Container, deren Berechtigungen überprüft wurden.