Пример — сценарии активного монитора PowerShell
Для сценария активного монитора PowerShell есть два созданных экземпляра объектов для поддержки успешного выполнения:
- . Реализация интерфейса IScriptContext. Этот объект предоставляет доступ к переменным среды выполнения а также механизм для возврата результатов клиенту. Несколько полезных методов перечислены далее.
- object GetProperty(string propertyName) — дает возможность извлечения значений контекстных переменных по имени.
- void SetResult(int resultCode) — дает возможность сценарию установить значение, указывающее на успешность выполнения, обычно 0 = успех 1 = ошибка.
- . Реализация интерфейса ILog. Этот объект дает доступ к методам, используемым к приложениям C#. Несколько полезных методов перечислены далее.
- void Error(string message) — создает относящуюся к ошибке запись журнала, включающую сообщение.
- void Information(string message) — создает относящуюся к информации запись журнала, включающую сообщение.
- void WriteLine(string message) — создает универсальную запись журнала, включающую сообщение.
Контекстные переменные
Следующие контекстные переменные доступны для использования в сценариях активных мониторов PowerShell:
- DeviceID
- DisplayName
- Address
- NetworkName
- Timeout
- CredWindows:DomainAndUserid
- CredWindows:Password
- CredSnmpV1:ReadCommunity
- CredSnmpV1:WriteCommunity
- CredSnmpV2:ReadCommunity
- CredSnmpV2:WriteCommunity
- CredSnmpV3:AuthPassword
- CredSnmpV3:AuthProtocol (значения: 1 = Нет, 2 = MD5, 3 = SHA)
- CredSnmpV3:EncryptProtocol (значения: 1 = Нет, 2 = DES56, 3 = AES128, 4 = AES192, 5 = AES256, 6 = THREEDES)
- CredSnmpV3:EncryptPassword
- CredSnmpV3:Username
- CredSnmpV3:Context
- CredADO:Password
- CredADO:Username
- CredSSH:Username
- CredSSH:Password
- CredSSH:EnablePassword
- CredSSH:Port
- CredSSH:Timeout
- CredVMware:Username
- CredVMware:Password
Тайм-аут сценария.
Можно установить значение тайм-аута сценария (в секундах). Если выполнение сценария не закончено после окончания периода тайм-аута, выполнение прерывается.
Минимум: 1
Максимум: 60
Стандартно: 60
Примеры сценариев
#
# Этот пример ищет процесс с именем 'outlook' и сообщает о его
# ответе или отсутствии ответа
#
# Используйте встроенный командлет с именем 'Get-Process', также имеющий псевдоним 'ps'
$processes = ps
$processName = "outlook"
$proc = $processes | where { $_.ProcessName -match $processName }
# Для сообщения о результатах активный монитор должен вызвать процедуру Context.SetResult()
if ($proc -eq $Null)
{
$NotRunningMessage = "Процесс '" + $processName + "' не выполняется."
$Context.SetResult(1, $NotRunningMessage )
}
else
{
if ($proc.Responding)
{
$RespondingMessage = "Процесс '" + $processName + "' выполняется."
$Context.SetResult(0, $RespondingMessage )
}
else
{
$NotRespondingMessage = "Процесс '" + $processName + "' не выполняется."
$Context.SetResult(1, $NotRunningMessage )
}
}