Compartir a través de


Set-TenantAllowBlockListItems

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 inquilinos permitidos o bloqueados en el portal de Microsoft 365 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.

Syntax

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

Description

En la mayoría de los casos, no se pueden modificar los valores de dirección URL, archivo o remitente de una entrada existente. La única excepción es permitir entradas url para simulaciones de suplantación de identidad (Action = Allow, ListType = URL y ListSubType = AdvancedDelivery). Para obtener más información sobre cómo permitir direcciones URL para simulaciones de suplantación de identidad (phishing), consulte Configuración de la entrega de simulaciones de suplantación de identidad de terceros a usuarios y mensajes sin filtrar a buzones de SecOps.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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 de permiso de dirección URL para la dirección URL de simulación de suplantación de identidad de terceros especificada.

Parámetros

-Allow

El modificador Allow especifica que está modificando una entrada allow. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Block

El modificador Bloquear especifica que va a modificar una entrada de bloque. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Entries

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

  • FileHash: valor hash de archivo SHA256 exacto.
  • Dominios de remitente y direcciones de correo electrónico: el valor exacto de dominio o dirección de correo electrónico.
  • Url: valor de dirección URL exacto.

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

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

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ExpirationDate

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 convierta la fecha y hora de la zona horaria local en UTC: por ejemplo, (Get-Date "5/6/2020 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.

No se puede usar este parámetro con el modificador NoExpiration.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Ids

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

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

No se puede usar este parámetro con el parámetro Entries.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ListSubType

El parámetro ListSubType especifica aún más la entrada que desea modificar. Los valores admitidos son:

Type:ListSubType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-ListType

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

  • FileHash
  • Remitente
  • Url

Use el parámetro Entries o Ids con este parámetro para identificar la propia entrada.

Type:ListType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-NoExpiration

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 entradas de bloque o con entradas url allow donde el valor del parámetro ListSubType es AdvancedDelivery.

No se puede usar este modificador con el parámetro ExpirationDate.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Notes

El parámetro Notes especifica información adicional sobre el objeto. Si el valor contiene espacios, escriba el valor entre comillas (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-OutputJson

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection