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 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 de remitente, dirección URL, archivo o dirección IP después de crear la entrada. La única excepción es la dirección 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 phishing, consulte Configuración de la directiva de entrega avanzada para simulaciones de suplantación de identidad (phishing) que no son de Microsoft y entrega de correo electrónico a buzones 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 se le asignan. 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 no de Microsoft especificada.
Parámetros
-Allow
Aplicable: Exchange Online, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
El modificador Allow especifica que está modificando una entrada allow. 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 |
| Obligatorio: | 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, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
El modificador Bloquear especifica que va a modificar 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 |
| Obligatorio: | 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, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
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.
- IP: solo direcciones IPv6. Las direcciones IPv6 únicas en formato de compresión cero o dos puntos hexadecimales o CIDR IPv6 oscilan entre 1 y 128.
Este valor se muestra en la propiedad Value de la entrada en la salida del cmdlet Get-TenantAllowBlockListItems.
No puede combinar tipos de valor (remitente, dirección URL, archivo o dirección IP) ni permitir y bloquear acciones en el mismo comando.
No se 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 |
| Obligatorio: | 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, Cumplimiento de & de seguridad, 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 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 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 |
| Obligatorio: | 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, Cumplimiento de & de seguridad, 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 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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Ids
| Posición: | Named |
| Obligatorio: | 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, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
El parámetro ListSubType especifica aún más la entrada que desea modificar. Los valores admitidos son:
- AdvancedDelivery: use este valor para las direcciones URL de simulación de phishing. Para obtener más información, consulte Configuración de la directiva de entrega avanzada para simulaciones de suplantación de identidad (phishing) que no son de Microsoft y entrega de correo electrónico a buzones de SecOps.
- Inquilino: este valor es el predeterminado.
Propiedades de parámetro
| Tipo: | ListSubType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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, Cumplimiento de & de seguridad, 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 propia entrada.
Propiedades de parámetro
| Tipo: | ListType |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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, Cumplimiento de & de seguridad, 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.
- Las direcciones URL permiten entradas donde el valor del parámetro ListSubType es AdvancedDelivery.
- Entradas de permiso de dirección IP.
No se puede 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 |
| Obligatorio: | 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, Cumplimiento de & de seguridad, 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 (").
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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, Cumplimiento de & de seguridad, Complemento de seguridad integrado para buzones locales
El parámetro RemoveAfter habilita remove en>45 días después de la última característica de fecha usada para una entrada allow. La propiedad LastUsedDate se rellena cuando el sistema de filtrado encuentra la entidad incorrecta en la entrada allow durante el flujo de correo o la hora de clic. La entrada allow se mantiene 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 puede usar este parámetro con los parámetros ExpirationDate o NoExpirationDate.
Para cambiar la entrada allow a un valor estático de fecha y hora de expiración que no depende 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 |
| Obligatorio: | 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.