Set-TenantAllowBlockListItems

Módulo:
Exchange PowerShell

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Set-TenantAllowBlockListItems para modificar las entradas de la lista de permitidos o bloqueados de inquilinos en el portal de Microsoft Defender.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

Ids (valor predeterminado) 

Set-TenantAllowBlockListItems
    -Ids <String[]>
    -ListType <ListType>
    [-Allow]
    [-Block]
    [-ExpirationDate <DateTime>]
    [-ListSubType <ListSubType>]
    [-NoExpiration]
    [-Notes <String>]
    [-OutputJson]
    [-RemoveAfter <Int32>]
    [<CommonParameters>]

Entries 

Set-TenantAllowBlockListItems
    -Entries <String[]>
    -ListType <ListType>
    [-Allow]
    [-Block]
    [-ExpirationDate <DateTime>]
    [-ListSubType <ListSubType>]
    [-NoExpiration]
    [-Notes <String>]
    [-OutputJson]
    [-RemoveAfter <Int32>]
    [<CommonParameters>]

Description

En la mayoría de los casos, no puede modificar los valores del remitente, la dirección URL, el archivo o la dirección IP después de crear la entrada. La única excepción es la URL permitir entradas para simulaciones de suplantación de identidad (ListType = URL, ListSubType = AdvancedDelivery). Para obtener más información sobre cómo permitir direcciones URL para simulaciones de suplantación de identidad (phishing), consulte Configurar la directiva de entrega avanzada para simulaciones de phishing que no son de Microsoft y entrega de correo electrónico a buzones de correo electrónico de SecOps.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()

En este ejemplo se cambia la fecha de expiración de la entrada especificada.

Ejemplo 2

Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021

En este ejemplo se cambia la fecha de expiración de la entrada URL de permiso para la dirección URL de simulación de suplantación de identidad que no es de Microsoft especificada.

Parámetros

-Allow

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El modificador Permitir especifica que estás modificando una entrada de permiso. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Block

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El modificador de bloqueo especifica que estás modificando una entrada de bloque. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Entries

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El parámetro Entradas especifica las entradas que desea modificar en función del valor del parámetro ListType. Los valores admitidos son:

  • FileHash: el valor hash exacto del archivo SHA256.
  • Dominios del remitente y direcciones de correo electrónico: el valor exacto del dominio o de la dirección de correo electrónico.
  • Dirección URL: el valor exacto de la dirección URL.
  • IP: Solo direcciones IPv6. Direcciones IPv6 únicas en formato hexadecimal de dos puntos o compresión cero o CIDR IPv6 oscila entre 1 y 128.

Este valor se muestra en la propiedad Valor de la entrada en la salida del cmdlet de Get-TenantAllowBlockListItems.

No puede mezclar tipos de valor (remitente, dirección URL, archivo o IP) ni permitir y bloquear acciones en el mismo comando.

No puede usar este parámetro con el parámetro Ids.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Entries
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExpirationDate

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El parámetro ExpirationDate filtra los resultados por fecha de expiración en hora universal coordinada (UTC).

Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:

  • Especifique el valor de fecha y hora en UTC: Por ejemplo, "2021-05-06 14:30:00z".
  • Especifique el valor de fecha y hora como una fórmula que convierte la fecha y hora de la zona horaria local a UTC: Por ejemplo, (Get-Date "5/6/2020 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.

No puede usar este parámetro con los parámetros NoExpiration o RemoveAfter.

Propiedades de parámetro

Tipo:DateTime
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Ids

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El parámetro Ids especifica las entradas que desea modificar. Este valor se muestra en la propiedad Identity en la salida del cmdlet de Get-TenantAllowBlockListItems.

Un valor de ejemplo para este parámetro es RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.

No puede usar este parámetro con el parámetro Entradas.

Propiedades de parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Ids
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ListSubType

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El parámetro ListSubType especifica además la entrada que desea modificar. Los valores admitidos son:

Propiedades de parámetro

Tipo:ListSubType
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ListType

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El parámetro ListType especifica el tipo de entrada que desea modificar. Los valores admitidos son:

  • FileHash
  • Remitente
  • Url
  • IP

Use el parámetro Entries o Ids con este parámetro para identificar la entrada en sí.

Propiedades de parámetro

Tipo:ListType
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-NoExpiration

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El modificador NoExpiration especifica que la entrada nunca debe expirar. No es necesario especificar un valor con este modificador.

Este modificador está disponible para usarse con los siguientes tipos de entradas:

  • Bloquear entradas.
  • URL permite entradas donde el valor del parámetro ListSubType es AdvancedDelivery.
  • Dirección IP permitir entradas.

No puedes usar este modificador con el parámetro ExpirationDate.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Notes

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El parámetro Notes especifica información adicional sobre el objeto. Si el valor contiene espacios, escriba el valor entre comillas ("). Si el valor contiene comillas, agregue una barra diagonal inversa ( \ ) antes de las comillas.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OutputJson

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El modificador OutputJson especifica si se devuelven todas las entradas en un único valor JSON. No es necesario especificar un valor con este modificador.

Utilice este modificador para evitar que el comando se detenga en la primera entrada que contiene un error de sintaxis.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveAfter

Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales

El parámetro RemoveAfter habilita la característica Quitar 45>días después de la última fecha utilizada para una entrada de permiso. La propiedad LastUsedDate se rellena cuando el sistema de filtrado detecta la entidad incorrecta en la entrada de permiso durante el flujo de correo o el momento en que se hace clic. La entrada de permiso se conserva durante 45 días después de que el sistema de filtrado determine que la entidad está limpia.

El único valor válido para este parámetro es 45.

No puedes usar este parámetro con los parámetros ExpirationDate o NoExpirationDate.

Para cambiar la entrada de permiso a un valor de fecha y hora de expiración estática que no dependa de la propiedad LastUsedDate, ejecute un comando Set-TenantAllowBlockListItems con el parámetro ExpirationDate.

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.