Get-CsAdForest

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni che indicano se la foresta di Active Directory in uso è stata configurata correttamente per l'installazione di Microsoft Lync Server 2010.

Sintassi

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

Descrizione dettagliata

Prima di poter installare Lync Server 2010 è necessario apportare diverse modifiche a livello di foresta in Servizi di dominio Active Directory. Esse comprendono la creazione di specificatori di visualizzazione e oggetti specifici per Lync Server, nonché la creazione dei gruppi di protezione universali necessari per gestire Lync Server e la concessione a questi gruppi di autorizzazioni di accesso alle impostazioni globali. Il cmdlet Get-CsAdForest restituisce un valore singolo che indica se Lync Server può essere installato in una foresta. Se Get-CsAdForest restituisce il valore LC_FORESTSETTINGS_STATE_READY, è possibile installare Lync Server nella foresta. Se il cmdlet restituisce LC_FORESTSETTINGS_STATE_NOT_READY, è necessario preparare la foresta nel modo corretto, prima di tentare l'installazione di Lync Server.

Get-CsAdForest viene eseguito come parte dell'installazione guidata. Se l'installazione guidata determina che la foresta non è preparata correttamente, verrà visualizzato un messaggio di errore e l'installazione verrà interrotta. Tuttavia, è possibile eseguire Get-CsAdForest indipendentemente dall'installazione guidata per verificare lo stato della foresta prima di ritentare l'installazione di Lync Server.

Get-CsAdForest ha la stessa funzione del comando Microsoft Office Communications Server 2007 R2 seguente:

Lcscmd.exe /forest /action:CheckForestPrepState

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, chiunque disponga delle autorizzazioni di lettura per Active Directory può eseguire il cmdlet Get-CsAdForest in locale. In genere tutti i membri del dominio dispongono di questa autorizzazione.

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

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
GlobalCatalog	Facoltativo	Stringa	Il nome di dominio completo di un server di catalogo globale nel dominio in uso. Se si esegue Get-CsAdForest su un computer che dispone di un account nel dominio, questo parametro non è obbligatorio.
GlobalSettingsDomainController	Facoltativo	Stringa	Nome di dominio completo di un controller di dominio in cui sono archiviate le impostazioni globali. Se in Servizi di dominio Active Directory le impostazioni globali sono archiviate nel contenitore di sistema, questo parametro deve puntare al controller di dominio radice. Se le impostazioni globali sono archiviate nel contenitore della configurazione, è possibile utilizzare qualsiasi dominio e omettere questo parametro.
RootDomainController	Facoltativo	Stringa	Nome di dominio completo del controller di dominio radice utilizzato per creare i percorsi di attendibilità per i client che devono accedere alle risorse in domini diversi dal proprio.
Report	Facoltativo	Stringa	Consente di specificare un percorso per il file di registro creato durante l'esecuzione del cmdlet. Ad esempio: -Report "C:\Logs\ForestPrep.html"
SkipPrepareCheck	Facoltativo	Booleano	Se il parametro è impostato su True ($True), Get-CsAdForest viene eseguito senza svolgere i controlli di preparazione iniziali.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsAdForest restituisce istanze dell'oggetto Microsoft.Rtc.Management.Deployment.LcForestSettingsState.

Esempio

-------------------------- Esempio 1 --------------------------

Get-CsAdForest

Nell'esempio precedente vengono restituite informazioni che indicano se la foresta di Active Directory in uso è stata configurata correttamente per l'installazione di Lync Server.

-------------------------- Esempio 2 --------------------------

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

Nell'esempio 2 vengono restituite le informazioni sullo stato della foresta e sullo schermo viene visualizzata la preparazione della foresta. Inoltre, informazioni dettagliate sulla procedura adottata per determinare lo stato della foresta vengono scritte in un file denominato C:\Logs\Forest_State.html. Il file contiene un elenco dettagliato di tutti i gruppi di Active Directory e i contenitori di Active Directory di cui sono state verificate le autorizzazioni.