Get-CsUserDatabaseState
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni sullo stato online (True o False) di uno o più database di utenti di Microsoft Lync Server 2010.
Sintassi
Get-CsUserDatabaseState [-Identity <String>]
Get-CsUserDatabaseState [-RegistrarPool <Fqdn>]
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 Get-CsUserDatabaseState consente di verificare lo stato corrente, online oppure offline, di qualsiasi database utenti attualmente in uso nell'organizzazione.
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 Get-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 tuttavia Get-CsUserDatabaseState da postazione remota, sarà necessario 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 Get-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 "Get-CsUserDatabaseState"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Facoltativo |
Stringa |
Identificatore univoco del database utente di cui deve essere restituito lo stato online. 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. Se si omettono entrambi i parametri, Get-CsUserDatabaseState restituirà informazioni su tutti i database utenti attualmente in uso. |
RegistrarPool |
Facoltativo |
Stringa |
Nome di dominio completo del pool Registrar che ospita i database utenti di cui restituire lo stato online. Ad esempio: -RegistrarPool "atl-cs-001.litwareinc.com". Non è possibile utilizzare i parametri Identity e RegistrarPool nello stesso comando né specificare caratteri jolly in questi parametri. Se si omettono entrambi i parametri, Get-CsUserDatabaseState restituirà informazioni su tutti i database utenti attualmente in uso. |
Tipi di input
Nessuno. Get-CsUserDatabaseState non accetta l'input da pipeline.
Tipi restituiti
Get-CsUserDatabaseState restituisce le istanze dell'oggetto Microsoft.Rtc.Management.Xds.UserStoreState.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsUserDatabaseState
Con il comando mostrato nell'esempio 1 viene restituito lo stato online di ogni database utenti configurato per l'utilizzo nell'organizzazione.
-------------------------- Esempio 2 ------------------------
Get-CsUserDatabaseState -Identity "UserDatabase:atl-sql-001.litwareinc.com"
Con il comando mostrato nell'esempio 2 viene restituito lo stato online di un solo database utenti: ovvero il database con identità UserDatabase:atl-sql-001.litwareinc.com.
-------------------------- Esempio 3 ------------------------
Get-CsUserDatabaseState -RegistrarPool "atl-cs-001.litwareinc.com"
Nell'esempio 3 le informazioni sullo stato vengono restituite per tutti i database utenti inclusi nel pool di registrazione atl-cs-001.litwareinc.com.
-------------------------- Esempio 4 ------------------------
Get-CsUserDatabaseState | Where-Object {$_.Online -eq $True}
Nell'esempio precedente le informazioni vengono restituite per tutti i database utenti attualmente online. A tale scopo, il comando chiama innanzitutto Get-CsUserDatabaseState senza alcun parametro. Viene restituita una raccolta di tutti i database utenti un uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona unicamente i database con proprietà Online uguale a True.