Set-CsUserDatabaseState
Ultima modifica dell'argomento: 2012-03-27
Abilita o disabilita uno o più database utenti di Microsoft Lync Server 2010.
Sintassi
Set-CsUserDatabaseState -Online <$true | $false> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsUserDatabaseState -Identity <String> -Online <$true | $false> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
In Lync Server 2010 i database utenti (conosciuti anche come archivi personali) vengono utilizzati per gestire informazioni sulla presenza e il routing relative agli utenti di Lync Server. Il cmdlet Set-CsUserDatabaseState consente di cambiare lo stato di uno o più database utenti: è possibile utilizzare il cmdlet per mettere offline un database o per rimettere online un database disabilitato.
Per impostazione predefinita, le eccezioni del firewall per SQL Server Express non sono abilitate quando si installa Lync Server 2010 Standard Edition. Non sarà quindi possibile eseguire Set-CsUserDatabaseState da un'istanza remota di Windows PowerShell. Il comando infatti non potrà attraversare il firewall e accedere al database di SQL Server Express. Sarà comunque possibile eseguire il cmdlet localmente, ovvero sul server Standard Edition. Per eseguire Set-CsUserDatabaseState da postazione remota, sarà necessario tuttavia abilitare manualmente le eccezioni del firewall di SQL Server Express.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsUserDatabaseState i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserDatabaseState"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Stringa |
Identificatore univoco del database utenti il cui stato online deve essere modificato. Ad esempio: -Identity "UserDatabase:atl-sql-001.litwareinc.com". Non è possibile utilizzare i parametri Identity e RegistrarPool nello stesso comando né specificare caratteri jolly in questi parametri. |
Online |
Obbligatorio |
Booleano |
Quando è impostato su True ($True), rende disponibile il database online. Quando è impostato su False ($False), mette il database offline. |
RegistrarPool |
Facoltativo |
Stringa |
Nome di dominio completo (FQDN) del pool di registrazione che ospita i database utenti il cui stato online deve essere modificato. Ad esempio: -RegistrarPool atl-cs-001.litwareinc.com. Non è possibile utilizzare i parametri –Identity e –RegistrarPool nello stesso comando né caratteri jolly con entrambi i parametri. |
Force |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
||
WhatIf |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
||
Confirm |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Stringa. Set-CsUserDatabaseState accetta un valore stringa che rappresenta l'identità del database utenti da aggiornare.
Tipi restituiti
Nessuno. Set-CsUserDatabaseState piuttosto modifica le istanze esistenti dell'oggetto Microsoft.Rtc.Management.Xds.UserStoreState.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com" -Online $False
Il comando mostrato nell'esempio 1 mette il database utenti UserDatabase:atl-sql-001.litwareinc.com offline. Questa operazione può essere eseguita impostando la proprietà Online su $False.
-------------------------- Esempio 2 ------------------------
Set-CsUserDatabaseState -RegistrarPool atl-cs-001.litwareinc.com -Online $False
Nell'esempio 2, tutti i database utenti nel pool di registrazione atl-cs-001.litwareinc.com sono messi offline.
-------------------------- Esempio 3 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $False} | ForEach-Object {Set-CsUserDatabaseState -Identity $_.Identity -Online $True}
L'esempio precedente individua tutti i database utenti attualmente offline e li riporta online. A tale scopo, il comando chiama innanzitutto Get-CsUserDatabaseState senza parametri in modo da restituire una raccolta di tutti i database utenti all'interno dell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona unicamente i database con proprietà Online uguale a False. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet ForEach-Object, che utilizza ogni database della raccolta e imposta la proprietà Online su True. La raccolta di database offline deve essere inviata tramite pipe a ForEach-Object anziché a Set-CsUserDatabaseState. Quest'ultimo cmdlet non è infatti in grado di accettare direttamente le informazioni da pipeline.