Get-CsAdDomain
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni che indicano se Servizi di dominio Active Directory è stato configurato correttamente per consentire l'installazione di Microsoft Lync Server 2010.
Sintassi
Get-CsAdDomain [-Domain <Fqdn>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-GlobalSettingsDomainController <Fqdn>] [-Report <String>]
Descrizione dettagliata
Prima dell'installazione di Lync Server 2010, è necessario preparare correttamente il dominio. Questo processo include l'estensione dello schema di Active Directory per consentire l'aggiunta di attributi specifici di Lync Server, nonché l'assegnazione delle voci di controllo di accesso necessarie per i gruppi universali utilizzati per la gestione e il funzionamento di Lync Server. Il cmdlet Get-CsAdDomain restituisce un singolo valore che indica se Lync Server può essere installato in un dominio. Se Get-CsAdDomain restituisce il valore LC_DOMAINSETTINGS_STATE_READY, è possibile installare Lync Server nel dominio specificato. Se il cmdlet restituisce LC_DOMAINSETTINGS_STATE_NOT_READY, è necessario preparare il dominio nel modo corretto, prima di tentare l'installazione di Lync Server.
Durante l'Installazione guidata viene eseguito Get-CsAdDomain. Se tramite la procedura guidata viene determinato che il dominio non è stato preparato correttamente, viene visualizzato un messaggio di errore e l'installazione si arresta. È tuttavia possibile eseguire Get-CsAdDomain indipendentemente dall'Installazione guidata per verificare lo stato del dominio prima di tentare l'installazione di Lync Server.
Get-CsAdDomain ha la stessa funzione del comando Microsoft Office Communications Server 2007 R2 seguente:
Lcscmd.exe /domain /action:CheckDomainPrepState
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, possono eseguire il cmdlet Get-CsAdDomain tutti gli utenti che dispongono di autorizzazioni di lettura per Active Directory. Tutti i membri di un dominio in genere dispongono di questa autorizzazione.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdDomain"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Domain |
Facoltativo |
Stringa |
Nome di dominio completo (FQDN) del dominio da controllare, ad esempio: -Domain "litwareinc.com". Se il parametro non viene specificato, verrà controllato il dominio locale. |
DomainController |
Facoltativo |
Stringa |
Consente agli amministratori di specificare il nome FQDN del controller di dominio da utilizzare quando si esegue Get-CsAdDomain. Se non viene specificato, il cmdlet utilizzerà il primo controller di dominio disponibile. |
GlobalCatalog |
Facoltativo |
Stringa |
Nome FQDN di un server di catalogo globale del dominio. Se si esegue Get-CsAdDomain su un computer che dispone di un account nel dominio, questo parametro non è obbligatorio. |
GlobalSettingsDomainController |
Facoltativo |
Stringa |
Nome FQDN di un controller di dominio in cui sono archiviate le impostazioni globali. Se le impostazioni globali sono archiviate nel contenitore di sistema in Active Directory, 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. |
Report |
Facoltativo |
Stringa |
Consente di specificare un percorso per il file di registro creato durante l'esecuzione del cmdlet. Ad esempio: -Report "C:\Logs\DomainPrep.html" |
Tipi di input
Nessuno. Get-CsAdDomain non accetta l'input da pipeline.
Tipi restituiti
Get-CsAdDomain restituisce istanze dell'oggetto Microsoft.Rtc.Management.Deployment.LcDomainSettingsState.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsAdDomain
Il comando precedente restituisce le informazioni relative allo stato corrente del dominio Active Directory locale. Se le impostazioni del dominio in uso sono corrette e il dominio è pronto per ospitare Lync Server 2010, viene restituito il valore LC_DOMAIN_SETTINGS_STATE_READY.
-------------------------- Esempio 2 --------------------------
Get-CsAdDomain -Domain "fabrikam.com"
Il comando mostrato nell'esempio 2 restituisce lo stato corrente di un dominio specifico: fabrikam.com. In un ambiente multidominio è possibile restituire informazioni relative a un determinato dominio includendo il parametro Domain.
-------------------------- Esempio 3 --------------------------
Get-CsAdDomain -Report "C:\Logs\DomainReport.html"
Nell'esempio 3 viene recuperato lo stato corrente del dominio Active Directory in uso e vengono inoltre scritte le informazioni relative allo stato in un file denominato C:\Logs\DomainReport.html. In questo file sono descritti in modo dettagliato i passaggi eseguiti da Get-CsAdDomain per determinare lo stato di conformità del dominio. Tra questi passaggi sono incluse attività quali la verifica della presenza di gruppi Active Directory e il controllo delle impostazioni delle autorizzazioni in diversi contenitori di Active Directory.