Install-CsDatabase

 

Ultima modifica dell'argomento: 2012-03-23

Installa uno o più database di Microsoft Lync Server 2010.

Sintassi

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>]]

Descrizione dettagliata

In Lync Server 2010 viene fatto un ampio uso dei database SQL Server, dall'archivio di gestione centrale al database di archiviazione. Come norma generale, tali database vengono impostati al momento dell'installazione di Lync Server 2010 o quando si installa un ruolo di Lync Server 2010 (quale ad esempio Monitoring Server) che richiede un database di back-end. Dopo l'installazione, di solito non è necessario reinstallare o spostare questi database.

In rare occasioni potrebbe tuttavia essere necessario installare manualmente un database di Lync Server 2010, ad esempio perché un database deve essere spostato in un altro server o perché si è verificato un problema di impostazione che ha impedito l'installazione del database. Il cmdlet Install-CsDatabase consente di installare qualsiasi database SQL Server utilizzato da Lync Server 2010.

Quando si esegue Install-CsDatabase, fondamentalmente è possibile gestire la configurazione del database da installare in tre modi diversi:

Opzione 1 - Eseguire il cmdlet senza includere un parametro che specifichi i percorsi di database. Quando si esegue Install-CsDatabase senza il parametro DatabasePath o UseDefaultSqlPath, viene utilizzato un algoritmo predefinito per scegliere il percorso di archiviazione dei file di dati e dei registri di database. Tale algoritmo predefinito funziona con un server SQL Server autonomo, non con un cluster SQL Server. Per poter installare un database in un cluster SQL Server, è necessario includere nel comando il parametro DatabasePath o UseDefaultSqlPath.

Opzione 2 - Eseguire il cmdlet con il parametro DatabasePath. Quando si esegue Install-CsDatabase con il parametro DatabasePath, non viene utilizzato l'algoritmo predefinito per scegliere il percorso di archiviazione dei file di dati e dei registri di database. Tale percorso può invece essere selezionato dagli amministratori. Per installare i file di dati e i registri di SQL Server nello stesso percorso, è sufficiente specificare il percorso della cartella in cui devono essere archiviati questi dati. Ad esempio:

-DatabasePath C:\SqlData

Per archiviare i file di dati e i file di registro in due percorsi diversi, specificare il percorso dell'una e dell'altra cartella utilizzando una virgola come carattere di separazione. Prestare attenzione a non inserire uno spazio prima o dopo la virgola:

-DatabasePath C:\SqlLogs,D:\SqlData

I file di registro verranno sempre archiviati nel primo percorso specificato, mentre i file di dati verranno archiviati nel secondo.

Nel back-end di un pool alcuni file di registro potrebbero essere archiviati da soli in un'unità disco. Se il back-end del pool dispone di un'unica unità, i file verranno distribuiti come indicato di seguito:

Unità 1 - Registro Rtcdyn, registro Rtc, altri registri, altri dati.

Se si dispone di due unità, i file verranno distribuiti come indicato di seguito:

Unità 1 - Registro Rtcdyn, registro Rtc.

Unità 2 - Altri registri, altri dati.

Con tre unità:

Unità 1 - Registro Rtcdyn.

Unità 2 - Registro Rtc.

Unità 3 - Altri registri, altri dati.

E con quattro unità:

Unità 1 - Registro Rtcdyn.

Unità 2 - Registro Rtc.

Unità 3 - Altri registri.

Unità 4 - Altri dati.

Per ulteriori informazioni e scenari di installazione, vedere la guida alla distribuzione di Lync Server 2010 Enterprise Edition.

Opzione 3 - Eseguire il cmdlet con il parametro UseDefaultSqlPaths. Quando si esegue Install-CsDatabase con il parametro UseDefaultSqlPaths, non viene utilizzato l'algoritmo predefinito per scegliere i percorsi di archiviazione dei file di dati e dei registri di database. Tali file vengono invece archiviati nei percorsi predefiniti di SQL Server, configurati preventivamente da un amministratore di SQL Server. I file di dati verranno perciò archiviati nel percorso dei file di dati predefinito di SQL Server, mentre i file di registro verranno archiviati nel percorso dei file di registro predefinito di SQL Server.

Prima di eseguire Install-CsDatabase, è consigliabile verificare che il gruppo RTCUniversalServerAdmins non sia stato assegnato come proprietario del database. Se tale gruppo risulta elencato come proprietario, potrebbe venire eliminato alla chiamata di Install-CsDatabase.

Utenti autorizzati a eseguire il cmdlet: per eseguire il cmdlet Install-CsDatabase in locale, è necessario essere membri del dominio, membri del gruppo RTCUniversalReadOnlyAdmins, amministratori di SQL Server e amministratori locali nel computer in cui è installato SQL Server. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

CentralManagementDatabase

Facoltativo

Parametro opzionale

Se questo parametro viene incluso, Install-CsDatabase utilizzerà il parametro SqlServerFqdn per installare l'archivio di gestione centrale nel computer specificato. Tale parametro di solito viene utilizzato esclusivamente dallo Generatore di topologie e generalmente viene chiamato solo una volta, durante l'impostazione iniziale.

Clean

Facoltativo

Parametro opzionale

Se questo parametro viene incluso, Install-CsDatabase eliminerà e reinstallerà i database come necessario. Se questo parametro non viene incluso, Install-CsDatabase non sovrascriverà alcun database esistente. Non è possibile utilizzare Clean e Update nello stesso comando.

Collocated

Facoltativo

Parametro opzionale

Se questo parametro è presente, gli ulteriori ruoli del database verranno collocati nell'archivio di gestione centrale.

ConfiguredDatabases

Facoltativo

Parametro opzionale

Legge le informazioni della topologia di Lync Server 2010 e installa i database necessari nel computer SQL Server o nel cluster SQL Server specificato. Gli amministratori che devono chiamare Install-CsDatabase utilizzeranno quasi sempre questo parametro al momento di specificare i database da installare.

DatabasePaths

Facoltativo

Stringa

Consente di specificare le unità e le cartelle in cui possono essere archiviati i file di registro e i file di dati come, ad esempio, -DatabasePaths "D:\Logs","E:\Data".

DatabaseType

Facoltativo

Stringa

Consente di installare un database specifico in un computer SQL Server o cluster SQL Server specifico. Come norma generale, gli amministratori non dovrebbero eseguire Install-CsDatabase con il parametro DatabaseType, a meno che non siano state fornite istruzioni in merito dal personale di supporto Microsoft. Dovrebbero invece utilizzare di solito il parametro ConfiguredDatabases. Con il parametro DatabaseType è necessario conoscere il tipo e il percorso esatti di ciascun database utilizzato nella topologia. Tale parametro inoltre è richiesto soltanto se l'esecuzione del comando Install-CsDatabase con il parametro ConfiguredDatabases ha esito negativo.

I valori validi per DatabaseType sono i seguenti:

Application

Archiving

Monitoring

Provision

User

ExcludeCollocatedStores

Facoltativo

Parametro opzionale

Se presente, non verrà visualizzato un messaggio di avviso indicante che eventuali archivi di database presenti devono essere installati nel computer locale.

ForDefaultInstance

Facoltativo

Parametro opzionale

Se questo parametro viene specificato, indica a Install-CsDatabase di agire soltanto sull'istanza predefinita di SQL Server. Non è possibile utilizzare ForDefaultInstance e ForInstance nello stesso comando.

ForInstance

Facoltativo

Stringa

Se questo parametro viene specificato, indica a Install-CsDatabase di agire soltanto sull'istanza di SQL Server specificata. Non è possibile utilizzare ForInstance e ForDefaultInstance nello stesso comando.

GlobalCatalog

Facoltativo

Stringa

Nome di dominio completo (FQDN) di un server di catalogo globale nel dominio in uso. Questo parametro non è necessario se Install-CsDatabase viene eseguito in un computer con un account nel dominio.

GlobalSettingsDomainController

Facoltativo

Stringa

Nome di dominio completo (FQDN) di un controller di dominio in cui sono archiviate le impostazioni globali. Se le impostazioni globali sono archiviate nel contenitore di sistema in Servizi di dominio Active Directory, questo parametro dovrà puntare al controller di dominio radice. Se le impostazioni globali sono archiviate nel contenitore della configurazione, sarà possibile utilizzare qualsiasi controller di dominio e omettere questo parametro.

LocalDatabases

Facoltativo

Parametro opzionale

Se questo parametro viene incluso, Install-CsDatabase leggerà nella topologia di Lync Server 2010 e installerà i database e gli archivi come necessario nel computer locale.

SkipPrepareCheck

Facoltativo

Parametro opzionale

Se presente, indica a Install-CsDatabase di non eseguire le relative verifiche di preparazione iniziali.

SqlInstanceName

Facoltativo

Stringa

Il nome dell'istanza del database in cui il database deve essere installato. Un'istanza del database è semplicemente un set di processi in esecuzione che forniscono accesso ai file di database. Se questo parametro viene omesso, Install-CsDatabase utilizzerà l'istanza predefinita di SQL Server.

SqlServerFqdn

Facoltativo

Stringa

Nome di dominio completo (FQDN) del computer in cui deve essere installato il database. Ad esempio: -SqlServerFqdn atl-sql-001.litwareinc.com.

Update

Facoltativo

Parametro opzionale

Se presente, consente l'aggiornamento del database esistente. Non è possibile utilizzare Update e Clean nello stesso comando.

UseDefaultSqlPaths

Facoltativo

Parametro opzionale

Se questo parametro viene specificato, indica a SQL Server di selezionare l'unità in cui archiviare i file di dati e i file di registro.

Force

Facoltativo

Parametro opzionale

Se presente, viene forzata l'installazione del nuovo database anche se un database esistente dello stesso tipo è attualmente in uso.

Report

Facoltativo

Stringa

Consente di specificare un percorso per il file di registro creato durante l'esecuzione del cmdlet. Ad esempio: -Report "C:\Logs\InstallDatabases.html"

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno. Install-CsDatabase non accetta l'input da pipeline.

Tipi restituiti

Install-CsDatabase non restituisce oggetti o valori.

Esempio

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

Install-CsDatabase -ConfiguredDatabases -SqlServerFqdn atl-sql-001.litwareinc.com -DatabasePaths "E:\CSLog","F:\CSLog","G:\CSDB"

Nell'esempio 1 Install-CsDatabase legge nella topologia di Lync Server 2010 e quindi installa tutti i database necessari nel pool atl-sql-001.litwareinc.com.

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

Install-CSDatabase -CentralManagementDatabase -SqlServerFqdn atl-sql-001.litwareinc.com -SqlInstanceName rtc -DatabasePaths "G:\CSDB"

Il comando mostrato nell'esempio 2 installa l'archivio di gestione centrale nel pool atl-sql-001.litwareinc.com. Il database verrà installato nell'istanza RTC e utilizzerà la cartella G:\CSDB.

Vedere anche

Ulteriori risorse

Uninstall-CsDatabase