Condividi tramite

  • Articolo

Set-CsHealthMonitoringConfiguration

 

Ultima modifica dell'argomento: 2012-03-25

Modifica una raccolta esistente di impostazioni di configurazione del monitoraggio dell'integrità. Queste impostazioni consentono agli amministratori di eseguire test per il controllo della qualità senza fornire il nome e la password degli account per i quali è richiesto il test.

Sintassi

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

Set-CsHealthMonitoringConfiguration [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Le transazioni sintetiche sono utilizzate in Microsoft Lync Server 2010 per verificare che gli utenti siano in grado di completare correttamente le attività comuni quali l'accesso al sistema, lo scambio di messaggi istantanei o l'effettuazione di telefonate a un telefono appartenente alla rete PSTN (Public Switched Telephone Network). Tali verifiche possono essere condotte manualmente da un amministratore oppure possono essere eseguite automaticamente tramite un'applicazione quale Microsoft System Center Operations Manager (in precedenza Microsoft Operations Manager).

È possibile condurre le transazioni in due diversi modi. Molti amministratori utilizzeranno i cmdlet CsHealthMonitoringConfiguration per configurare una account di test per ciascuno dei propri pool di registrazione. Questi account di test sono una coppia di account utente preconfigurati per essere utilizzati nell'ambito delle transazioni sintetiche. Generalmente si tratta di account di test e non di account appartenenti a utenti effettivi. Quando vengono configurati gli account di test per un pool, gli amministratori possono semplicemente eseguire una transazione sintetica su tale pool, senza dover specificare le identità degli account utente (e fornire le relative credenziali) coinvolti nel test. In realtà, la transazione sintetica utilizza automaticamente gli account di test preconfigurati durante l'esecuzione dei controlli.

In alternativa, gli amministratori possono eseguire una transazione sintetica utilizzando account utente effettivi. Ad esempio, se due utenti non riescono a scambiarsi messaggi istantanei, l'amministratore può eseguire una transazione sintetica utilizzando i due account in questione, anziché la coppia di account di test. Se si decide di condurre una transazione sintetica utilizzando gli account utente reali, sarà necessario fornire le credenziali per ogni utente.

Dopo aver configurato le impostazioni di configurazione del monitoraggio dell'integrità è possibile modificare tali impostazioni in qualsiasi momento con il cmdlet Set-CsHealthMonitoringConfiguration. Questo cmdlet fornisce un mezzo per modificare uno o entrambi gli account di test configurati per l'uso con un pool.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsHealthMonitoringConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

FQDN

Nome di dominio completo (FQDN) del pool a cui sono state assegnate le impostazioni di configurazione del monitoraggio dell'integrità da modificare. Ad esempio: -Identity atl-cs-001.litwareinc.com.

Instance

Facoltativo

Oggetto HealthMonitoringSettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

FirstTestSamAccountName

Facoltativo

Stringa

SamAccountName del primo utente di test. È necessario immettere FirstTestSamAccountName utilizzando il formato dominio\nome utente, ad esempio:

-FirstTestSamAccountName litwareinc\davidegarghentini

FirstTestUserSipUri

Facoltativo

Indirizzo SIP

Indirizzo SIP del primo utente di test da configurare per l'uso da parte di questa raccolta di impostazioni di monitoraggio dell'integrità. L'indirizzo SIP deve includere il prefisso sip:. Ad esempio: -FirstTestUserSipUri "sip:davidegarghentini@litwareinc.com".

SecondTestSamAccountName

Facoltativo

Stringa

SamAccountName del secondo utente di test. È necessario immettere SecondTestSamAccountName utilizzando il formato dominio\nome utente, ad esempio:

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Facoltativo

Indirizzo SIP

Indirizzo SIP del secondo utente di test da configurare per l'uso da parte di questa raccolta di impostazioni di monitoraggio dell'integrità. L'indirizzo SIP deve includere il prefisso sip:. Ad esempio: -FirstTestUserSipUri "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.

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings. Set-CsHealthMonitoringConfiguration consente di accettare istanze da pipeline dell'oggetto configurazione del monitoraggio dell'integrità.

Tipi restituiti

Nessuno. In realtà, Set-CsHealthMonitoringConfiguration modifica le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings.

Esempio

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

Set-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

Con il comando mostrato nell'esempio 1 viene configurato il primo utente di test assegnato alle impostazioni di configurazione del monitoraggio dell'integrità per il pool atl-cs-001.litwareinc.com. Con questo esempio, l'indirizzo SIP del nuovo utente di test viene impostato su sip:davidegarghentini@litwareinc.com e il SamAccountName per l'utente di test viene impostato su davidegarghentini.

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

Get-CsHealthMonitoringConfiguration | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

Il comando precedente è una variazione del comando mostrato nell'esempio 1. In questo caso, però, lo stesso utente di test viene assegnato ad ogni raccolta di impostazioni di configurazione del monitoraggio dello stato in uso nell'organizzazione. Per eseguire questa operazione, il comando utilizza per prima cosa Get-CsHealthMonitoringConfiguration per restituire una raccolta di tutte le impostazioni di configurazione del monitoraggio dell'integrità. La raccolta viene quindi inviata tramite pipe a Set-CsHealthMonitoringConfiguration, che assegna lo stesso indirizzo SIP del primo utente di test e lo stesso SamAccountName a ciascun elemento nella raccolta.

-------------------------- Esempio 3 ------------------------

Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:pilar@litwareinc.com"} | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

Con l'esempio 3 viene mostrato come eseguire una ricerca e sostituzione del primo utente di test assegnato a una raccolta di impostazioni di configurazione del monitoraggio dell'integrità; in questo esempio, l'utente con indirizzo SIP sip:pilar@litwareinc.com viene sostituito ogni volta che tale utente appare come primo utente di test in una raccolta.

Per eseguire questa attività, il comando chiama per prima cosa Get-CsHealthMonitoringConfiguration senza parametri aggiuntivi per restituire una raccolta di tutte le impostazioni di configurazione del monitoraggio dell'integrità attualmente in uso nell'organizzazione. Questa raccolta viene inviata tramite pipe all'oggetto Where-Object, che recupera solo gli elementi in cui la proprietà FirstTestUserSipUri è uguale a (-eq) sip:pilar@litwareinc.com. Tale raccolta filtrata viene a sua volta inviata tramite pipe a Set-CsHealthMonitoringConfiguration, che recupera ogni elemento nella raccolta e imposta il valore della proprietà FirstTestUserSipUri su sip:davidegarghentini@litwareinc.com e il valore della proprietà FirstTestSamAccountName su davidegarghentini.