Condividi tramite

  • Articolo

New-CsHealthMonitoringConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di creare una nuova raccolta di impostazioni di configurazione per il monitoraggio dello stato nell'organizzazione. Queste impostazioni consentono agli amministratori di eseguire test di controllo della qualità senza dover fornire nome utente e password per i necessari account.

Sintassi

New-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]

New-CsHealthMonitoringConfiguration -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> -TargetFqdn <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le transazioni sintetiche vengono utilizzate in Microsoft Lync Server 2010 per verificare che gli utenti siano in grado di completare correttamente normali attività, quali l'accesso al sistema, lo scambio di messaggi istantanei o l'esecuzione di chiamate a un telefono in una rete PSTN (Public Switched Telephone Network). Questi test possono essere eseguiti "manualmente" da un amministratore oppure automaticamente da un'applicazione (ad esempio, Microsoft System Center Operations Manager (in precedenza Microsoft Operations Manager)).

Per eseguire le transazioni sintetiche è possibile procedere in due modi. Alcuni amministratori utilizzano i cmdlet CsHealthMonitoringConfiguration per configurare account di test per ciascun pool di registrazione. Si tratta di una coppia di account utente appositamente preconfigurati per essere utilizzati nell'ambito delle transazioni sintetiche. Generalmente si tratta di account di test che non appartengono a utenti reali. Dopo aver configurato gli account di test per un pool, gli amministratori possono semplicemente eseguire una transazione sintetica su quel pool senza dover specificare le identità o fornire le credenziali degli account utente coinvolti nel test. Infatti, al momento di eseguire i controlli, la transazione sintetica utilizzerà automaticamente gli account di test predefiniti.

In alternativa, gli amministratori possono eseguire una transazione sintetica utilizzando degli account utente reali. Ad esempio, se due utenti non sono in grado di scambiare messaggi istantanei, un amministratore potrebbe eseguire una transazione sintetica utilizzando i due account utente in questione (piuttosto che degli account utente di test). Se si decide di eseguire una transazione sintetica utilizzando degli account utente reali, sarà necessario fornire le credenziali di tutti gli utenti coinvolti.

Il cmdlet New-CsHealthMonitoringConfiguration offre la possibilità di creare nuove impostazioni di configurazione per il monitoraggio dello stato per un pool. Quando si crea una nuova raccolta di impostazioni di configurazione per il monitoraggio dello stato si deve specificare il nome completo di dominio del pool così come l'indirizzo SIP dei due account che serviranno come account di test per il pool. Non è tuttavia necessario fornire la password di questi account di test. Si noti che ciascun pool può ospitare al massimo una singola raccolta di impostazioni di configurazione per il monitoraggio dello stato. Se si tenta di creare una nuova raccolta per il pool atl-cs-001.litwareinc.com e a questo pool è già stata assegnata una registrazione, il comando avrà esito negativo.

Quando si utilizza New-CsHealthMonitoringConfiguration si potrebbe ricevere un avviso se a qualche pool non sono stati assegnati utenti; questo può includere sia Director pool così come pool di Office Communications Server. Questo avviso può essere ignorato. Se si preferisce, è possibile assegnare utenti di test di altri pool ai propri pool di server Director, in modo da consentire l'utilizzo del cmdlet Test-CsRegistration per Director. Tuttavia, non è possibile assegnare utenti di test ai pool di Office Communications Server.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsHealthMonitoringConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

FQDN

Nome completo di dominio del pool al quale assegnare le impostazioni di configurazione per il monitoraggio dello stato (ad esempio: -Identity atl-cs-001.litwareinc.com). Il comando avrà esito negativo se il pool specificato ospita già una raccolta di impostazioni di configurazione per il monitoraggio dello stato.

Il parametro Identity è equivalente al parametro TargetFqdn. Quando si crea una nuova raccolta di impostazioni, si può utilizzare uno dei due parametri. Se si ignorano entrambi i parametri, New-CsHealthMonitoringConfiguration chiederà di immettere Identity.

TargetFqdn

Facoltativo

FQDN

Nome completo di dominio del pool al quale assegnare le impostazioni di configurazione per il monitoraggio dello stato (ad esempio: -TargetFqdn atl-cs-001.litwareinc.com). Il comando avrà esito negativo se il pool specificato ospita già una raccolta di impostazioni di configurazione per il monitoraggio dello stato.

Il parametro Identity è equivalente al parametro TargetFqdn. Quando si crea una nuova raccolta di impostazioni, si può utilizzare uno dei due parametri. Se si ignorano entrambi i parametri, New-CsHealthMonitoringConfiguration chiederà di immettere Identity.

FirstTestSamAccountName

Facoltativo

Stringa

SamAccountName del primo utente di test. FirstTestSamAccountName deve essere immesso utilizzando il formato dominio\nomeutente; ad esempio:

-FirstTestSamAccountName litwareinc\davidegarghentini

FirstTestUserSipUri

Facoltativo

Indirizzo SIP

Indirizzo SIP del primo utente di test da configurare per l'utilizzo in questa raccolta di impostazioni per il monitoraggio dello stato. Si noti che l'indirizzo SIP deve includere il prefisso sip:. Ad esempio: -FirstTestUserSipUri "sip:davidegarghentini@litwareinc.com".

SecondTestSamAccountName

Facoltativo

Stringa

SamAccountName del secondo utente di test. SecondTestSamAccountName deve essere immesso utilizzando il formato dominio\nomeutente; ad esempio:

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Facoltativo

Indirizzo SIP

Indirizzo SIP del secondo utente di test da configurare per l'utilizzo in questa raccolta di impostazioni per il monitoraggio dello stato. Si noti che l'indirizzo SIP deve includere il prefisso sip:. Ad esempio: -SecondTestUserSipUri "sip:pilar@litwareinc.com".

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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. New-CsHealthMonitoringConfiguration non accetta input tramite pipeline.

Tipi restituiti

New-CsHealthMonitoringConfiguration consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Esempio

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

New-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"

Il comando riportato nell'Esempio 1 consente di creare una nuova raccolta di impostazioni di configurazione per il monitoraggio dello stato per il pool atl-cs-001.litwareinc.com. Queste nuove impostazioni utilizzeranno sip:davidegarghentini@litwareinc.com e sip:pilar@litwareinc.com come i due account di test preconfigurati.

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

$x = Get-CsService -Registrar | Select-Object PoolFqdn
foreach ($i in $x)
   {New-CsHealthMonitoringConfiguration -Identity $i.PoolFqdn -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"}

Nell'Esempio 2 viene creata una nuova raccolta di impostazioni di configurazione per il monitoraggio dello stato per tutti i pool di registrazione dell'organizzazione. Per ottenere questo risultato, il primo comando nell'esempio utilizza il cmdlet Get-Service e il parametro Registrar per ottenere una raccolta di tutti i pool di registrazione. Questa raccolta viene poi inviata tramite pipe al cmdlet Select-Object che seleziona solo la proprietà PoolFqdn. Questa proprietà restituisce il nome completo di dominio (FQDN) di un pool di registrazione. Questi FQDN sono memorizzati in una variabile denominata $x.

Nel secondo comando, viene creato un ciclo foreach per prendere in esame ciascun FQDN dei pool di registrazione. Per ciascun FQDN, viene utilizzato New-CsHealthMonitoringConfiguration con il valore FQDN memorizzato nella variabile $x utilizzato come identità per la nuova raccolta di impostazioni. A ciascuna raccolta vengono assegnati gli stessi due account di test: sip:davidegarghentini@litwareinc.com e sip:pilar@litwareinc.com.