Compartir a través de

Set-AzureServiceAntimalwareExtension

  • Referencia
Módulo:
Azure

Configura la extensión Microsoft Antimalware para los servicios en la nube.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Importante

Cloud Services (clásico) ahora está en desuso para los nuevos clientes y se retirará el 31 de agosto de 2024 para todos los clientes. Las nuevas implementaciones deben utilizar el nuevo modelo de implementación basado en Azure Resource Manager Azure Cloud Services (soporte extendido) .

Sintaxis

Set-AzureServiceAntimalwareExtension
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-AntimalwareConfiguration] <XmlDocument>]
   [[-Monitoring] <String>]
   [[-StorageContext] <AzureStorageContext>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureServiceAntimalwareExtension
   [-ServiceName] <String>
   [[-Slot] <String>]
   [[-Role] <String[]>]
   [[-AntimalwareConfiguration] <XmlDocument>]
   [[-Monitoring] <String>]
   [[-StorageContext] <AzureStorageContext>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureServiceAntimalwareExtension configura la extensión Microsoft Antimalware para un servicio en la nube. Puede especificar valores que invaliden y complementan los valores en la configuración XML, como el contexto de la cuenta de almacenamiento.

Ejemplos

Ejemplo 1: Habilitar la extensión

PS C:\> [System.Xml.XmlDocument] $XmlConfig = New-Object System.Xml.XmlDocument 
PS C:\> $XmlConfig.load('C:\configuration\contosoVM.xml')
PS C:\> Set-AzureServiceAntimalwareExtension -ServiceName "ContosoService03" -AntimalwareConfiguration $XmlConfig
Operation succeeded

Los dos primeros comandos crean un objeto XmlDocument que contiene una configuración para la extensión Microsoft Antimalware y, a continuación, los almacena en la variable $XmlConfig.

Ejemplo 2: Habilitación de la extensión para el espacio de ensayo

PS C:\> [System.Xml.XmlDocument] $XmlConfig = New-Object System.Xml.XmlDocument 
PS C:\> $XmlConfig.load('C:\configuration\contosoVM.xml')
PS C:\> Set-AzureServiceAntimalwareExtension -ServiceName "ContosoService03" -Slot "Staging" -AntimalwareConfiguration $XmlConfig 
Operation succeeded

Los dos primeros comandos crean un objeto XmlDocument que contiene una configuración para la extensión Microsoft Antimalware y, a continuación, los almacena en la variable $XmlConfig.

Ejemplo 3: Habilitación de la extensión con supervisión

PS C:\> System.Xml.XmlDocument] $XmlConfig = New-Object System.Xml.XmlDocument 
PS C:\> $XmlConfig.load('C:\configuration\contosoVM.xml')
PS C:\> $StorageContext = New-AzureStorageContext -StorageAccountName "contosostoragemain" -StorageAccountKey (Get-AzureStorageKey -StorageAccountName "Contosostoragemain").Primary
PS C:\> Set-AzureServiceAntimalwareExtension -ServiceName "ContosoService03" -AntimalwareConfiguration $XmlConfig -Monitoring ON -StorageContext $StorageContext

Los dos primeros comandos crean un objeto XmlDocument que contiene una configuración para la extensión Microsoft Antimalware y, a continuación, los almacena en la variable $XmlConfig.

Parámetros

-AntimalwareConfiguration

Especifica un objeto XmlDocument que contiene la configuración de Microsoft Antimalware. Este objeto no debe estar $Null ni estar vacío. El objeto de configuración debe incluir, como mínimo, el siguiente contenido para habilitar la extensión Microsoft Antimalware:

\<AntimalwareConfig\>\<AntimalwareEnabled\>true\</AntimalwareEnabled\>\</AntimalwareConfig\>

Tipo:XmlDocument
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Monitoring

Especifica si se van a recopilar eventos de Microsoft Antimalware. Los valores válidos son:

  • EN. Recopile eventos de Microsoft Antimalware en el contexto de almacenamiento.

  • APAGADO. No recopile eventos de Microsoft Antimalware.

Tipo:String
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Role

Especifica una matriz de roles. El valor predeterminado es todos los roles.

Tipo:String[]
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServiceName

Especifica el nombre del servicio en la nube.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Slot

Especifica una ranura de implementación. Los valores válidos son:

  • Producción

  • Ensayo

El valor predeterminado es Production.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageContext

Especifica un contexto de almacenamiento de Azure para la supervisión de Microsoft Antimalware.

Tipo:AzureStorageContext
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False