Поделиться через


Set-AzureVMMicrosoftAntimalwareExtension

Настраивает расширение Защиты от вредоносных программ Майкрософт для виртуальной машины.

Примечание.

Командлеты, на которые ссылается эта документация, предназначены для управления устаревшими ресурсами Azure, используюющими API Azure Service Manager (ASM). Этот устаревший модуль PowerShell не рекомендуется при создании новых ресурсов, так как ASM планируется выйти на пенсию. Дополнительные сведения см. в статье о выходе на пенсию в Azure Service Manager.

Модуль Az PowerShell — это рекомендуемый модуль PowerShell для управления ресурсами Azure Resource Manager (ARM) с помощью PowerShell.

Синтаксис

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath (по умолчанию)

Set-AzureVMMicrosoftAntimalwareExtension
    [-AntimalwareConfigFile] <String>
    [[-Version] <String>]
    [[-Monitoring] <String>]
    [[-StorageContext] <AzureStorageContext>]
    -VM <IPersistentVM>
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

EnableMicrosoftAntimalwareExtensionJsonConfig

Set-AzureVMMicrosoftAntimalwareExtension
    [-AntimalwareConfiguration] <String>
    [[-Version] <String>]
    [[-Monitoring] <String>]
    [[-StorageContext] <AzureStorageContext>]
    -VM <IPersistentVM>
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

DisableMicrosoftAntimalwareExtension

Set-AzureVMMicrosoftAntimalwareExtension
    [[-Version] <String>]
    -VM <IPersistentVM>
    [-Disable]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

UninstallMicrosoftAntimalwareExtension

Set-AzureVMMicrosoftAntimalwareExtension
    -VM <IPersistentVM>
    [-Uninstall]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

ConfigureMicrosoftAntimalwareMonitoring

Set-AzureVMMicrosoftAntimalwareExtension
    [-Monitoring] <String>
    [[-StorageContext] <AzureStorageContext>]
    -VM <IPersistentVM>
    [-NoConfig]
    [-Profile <AzureSMProfile>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [<CommonParameters>]

Описание

Командлет Set-AzureVMMicrosoftAntimalwareExtension настраивает расширение Защиты от вредоносных программ Майкрософт для виртуальной машины. Вы можете включить, отключить или удалить расширение.

Примеры

Пример 1. Включение расширения с помощью файла конфигурации

PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name "ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -AntimalwareConfigFile 'C:\configuration\contosoVM.json' | Update-AzureVM

Эта команда включает расширение Защиты от вредоносных программ Майкрософт с помощью файла конфигурации. Команда использует командлет Get-AzureVM для получения указанного объекта виртуальной машины, а затем передает объект текущему командлету с помощью оператора конвейера.

Пример 2. Включение расширения и включение мониторинга

PS C:\> $StorageContext = New-AzureStorageContext -StorageAccountName "contosostoragemain" -StorageAccountKey (Get-AzureStorageKey -StorageAccountName "Contosostoragemain").PrimaryP
S C:\> Get-AzureVM -ServiceName "ContosoService03" -Name"ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -AntimalwareConfigFile 'C:\configuration\contosoVM.json" -Monitoring ON -StorageContext $StorageContext | Update-AzureVM

Первая команда создает объект AzureStorageContext с помощью командлета New-AzureStorageContext , а затем сохраняет его в переменной $StorageContext.

Пример 3. Включение расширения путем указания объекта конфигурации

PS C:\> $Config_String = [IO.File]::ReadAllText('C:\configuration\contosoVM.json')
PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name "ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -AntimalwareConfiguration $Config_String | Update-AzureVM

Первая команда создает строковый объект, считывая конфигурацию JSON для расширения Защиты от вредоносных программ Майкрософт, а затем сохраняя ее в переменной $config_string.

Пример 4. Отключение расширения

PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name "ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -Disable | Update-AzureVM

Эта команда отключает расширение, не удаляя его. Команда использует Get-AzureVM для получения указанного объекта виртуальной машины, а затем передает объект текущему командлету.

Пример 5. Удаление расширения

PS C:\> Get-AzureVM -ServiceName "ContosoService03" -Name"ContosoVM22" | Set-AzureVMMicrosoftAntimalwareExtension -Uninstall | Update-AzureVM

Эта команда удаляет расширение Защиты от вредоносных программ Майкрософт из виртуальной машины. Команда использует Get-AzureVM для получения указанного объекта виртуальной машины, а затем передает объект текущему командлету.

Параметры

-AntimalwareConfigFile

Указывает абсолютный путь к файлу конфигурации Антивредоносного ПО Майкрософт. Не указывайте этот параметр, если указать параметр AntimalwareConfiguration. Файл конфигурации должен содержать как минимум следующее содержимое, чтобы включить расширение Защиты от вредоносных программ Майкрософт:

{ "AntimalwareEnabled": true }

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-AntimalwareConfiguration

Указывает строковый объект, содержащий конфигурацию Антивредоносного поверх Майкрософт. Этот объект не должен быть $Null или пустым. Не указывайте этот параметр, если указать параметр AntimalwareConfigFile. Объект конфигурации должен включать, как минимум, следующее содержимое, чтобы включить расширение Антивредоносного поверх Майкрософт: ***{ "AntimalwareEnabled": true }

Пример конфигурации в формате JSON для Microsoft Antimalware:

{ "AntimalwareEnabled": true, "RealtimeProtectionEnabled": true, "ScheduledScanSettings": { "isEnabled": true, "day": 1, "time": 120, "scanType": "Full" },

"Исключения": { "Расширения": ".ext1;. ext2", "Paths": "c:\excluded-path-1; c:\excluded-path-2", "Процессы": "excludedproc1.exe; excludedproc2.exe" }

}

Примечание. AntimalwareEnabled является обязательным параметром. Значения: true= Enable. false= Ошибка, так как false не является поддерживаемым значением

RealtimeProtectionEnabled: true/false. true = Включить. false = Отключить. Значение по умолчанию — true.

ScheduledScanSettings: isEnabled=true/false day=0-8 (0-daily, 1-воскресенье, 2-понедельник, ...., 7-суббота, 8-Отключено) time=0-1440 (измеряется в минутах после полуночи - 60-1AM>, 120> - 2AM, ... ) scanType="Quick" или "Full" (По умолчанию — быстрая) Примечание. Если isEnabled=true задан единственный параметр, указанные по умолчанию: day=7 (суббота), time=120 (2 AM), scanType="Quick" Исключения: Несколько исключений в одном списке указываются с помощью разделителей с запятой.

Если исключения не указаны, существующие исключения, если таковые имеются, перезаписываются пустыми в системе.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EnableMicrosoftAntimalwareExtensionJsonConfig
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Disable

Указывает, что командлет отключает расширение Защиты от вредоносных программ Майкрософт. Чтобы повторно включить расширение на той же виртуальной машине, выполните команду Set-AzureVMMicrosoftAntimalwareExtension без параметра Disable.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DisableMicrosoftAntimalwareExtension
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-InformationAction

Указывает, как этот командлет реагирует на событие сведений.

Допустимые значения для этого параметра:

  • Продолжить
  • Пропустить
  • Спрашивать
  • SilentlyContinue
  • Остановить
  • Приостановить

Свойства параметра

Тип:ActionPreference
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:infa

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-InformationVariable

Указывает переменную сведений.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:iv

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Monitoring

Указывает, следует ли собирать события защиты от вредоносных программ Майкрософт.

Допустимые значения для этого параметра:

  • НА. Сбор событий защиты от вредоносных программ Майкрософт в контексте хранения.
  • ОТ. Не собираем события защиты от вредоносных программ Майкрософт.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:3
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
EnableMicrosoftAntimalwareExtensionJsonConfig
Position:3
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-NoConfig

Указывает, что этот командлет задает параметр NoConfig.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ConfigureMicrosoftAntimalwareMonitoring
Position:3
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Profile

Указывает профиль Azure, из которого считывается этот командлет. Если профиль не указан, этот командлет считывается из локального профиля по умолчанию.

Свойства параметра

Тип:AzureSMProfile
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StorageContext

Указывает контекст хранилища Azure для мониторинга антивредоносных программ Майкрософт.

Свойства параметра

Тип:AzureStorageContext
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:4
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
EnableMicrosoftAntimalwareExtensionJsonConfig
Position:4
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
ConfigureMicrosoftAntimalwareMonitoring
Position:4
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Uninstall

Указывает, что этот командлет удаляет расширение Защиты от вредоносных программ Майкрософт из виртуальной машины. Если мониторинг включен, командлет также удаляет коллекцию событий защиты от вредоносных программ Майкрософт.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

UninstallMicrosoftAntimalwareExtension
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Version

Указывает версию расширения в виде строки. Примечание. Поддерживаемая версия — 1.5. Старые версии не поддерживаются корпорацией Майкрософт.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

EnableMicrosoftAntimalwareExtensionJsonConfigFilePath
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
EnableMicrosoftAntimalwareExtensionJsonConfig
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False
DisableMicrosoftAntimalwareExtension
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-VM

Указывает виртуальную машину как объект IPersistentVM.

Свойства параметра

Тип:IPersistentVM
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ОбъектВвода

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.