New-TenantAllowBlockListItems
Este cmdlet solo está disponible en el servicio basado en la nube.
Use el cmdlet New-TenantAllowBlockListItems para agregar entradas a 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
Expiration
New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-RemoveAfter <Int32>]
[-SubmissionID <String>]
[<CommonParameters>]
NoExpiration
New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-RemoveAfter <Int32>]
[-SubmissionID <String>]
[<CommonParameters>]
Description
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
New-TenantAllowBlockListItems -ListType Url -Block -Entries ~contoso.com~
En este ejemplo se agrega una entrada de bloque de direcciones URL para contoso.com y todos los subdominios (por ejemplo, contoso.com, www.contoso.com, xyz.abc.contoso.com y www.contoso.com/b). Dado que no se usaron los parámetros ExpirationDate o NoExpiration, la entrada expira después de 30 días.
Ejemplo 2
New-TenantAllowBlockListItems -ListType FileHash -Block -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpiration
En este ejemplo se agrega una entrada de bloque de archivos para los archivos especificados que nunca caduca.
Ejemplo 3
New-TenantAllowBlockListItems -Allow -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -NoExpiration
En este ejemplo se agrega una entrada de URL allow para la URL de simulación de phishing que no es de Microsoft especificada sin expiración. Para obtener más información, consulte Configuración de la directiva de entrega avanzada para simulaciones de phishing que no son de Microsoft y entrega de correo electrónico a buzones de correo de SecOps.
Ejemplo 4
New-TenantAllowBlockListItems -Allow -ListType Url -Entries abcd.fabrikam.com -RemoveAfter 45
En este ejemplo se agrega una entrada de URL permitida para el dominio especificado con expiración como 45 días después de la última fecha de uso. Esto permite la entrada de direcciones URL identificadas como masivas, spam, correo no deseado de alta confianza y suplantación de identidad (no phishing de alta confianza).
Para las direcciones URL identificadas como malware o suplantación de identidad de alta confianza, debe enviar las direcciones URL que Microsoft cree para permitir entradas. Para obtener instrucciones, consulte Notificar direcciones URL correctas a Microsoft.
Parámetros
-Allow
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El modificador Permitir especifica que vas a crear una entrada de permiso. No es necesario especificar un valor con este modificador.
No puede usar este modificador con el modificador de bloqueo.
Nota: Consulte Permitir entradas en la lista de permitidos/bloqueados de inquilinos, antes de intentar crear una entrada de permiso.
También puede usar permitir entradas para direcciones URL de simulación de suplantación de identidad que no sean de Microsoft sin expiración. Para obtener más información, consulte Configuración de la directiva de entrega avanzada para simulaciones de phishing que no son de Microsoft y entrega de correo electrónico a buzones de correo de SecOps.
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 Permitir especifica que está creando una entrada de bloque. No es necesario especificar un valor con este modificador.
No puede usar este modificador con el modificador Permitir.
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 los valores que desea agregar a la lista de permitidos/bloqueados de inquilinos en función del valor del parámetro ListType:
FileHash: use el valor hash SHA256 del archivo. Puede encontrar el valor hash SHA256 ejecutando el siguiente comando en PowerShell:
Get-FileHash -Path "<Path>\<Filename>" -Algorithm SHA256. Un valor de ejemplo es768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3.Remitente: un dominio o valor de dirección de correo electrónico. Por ejemplo,
contoso.comomichelle@contoso.com.URL: usa direcciones IPv4 o IPv6 o nombres de host. Los comodines (* y ~) se admiten en los nombres de host. No se admiten protocolos, puertos TCP/UDP ni credenciales de usuario. Para obtener más información, consulte Sintaxis de URL para la lista de permitidos o bloqueados de inquilinos.
IP: Solo direcciones IPv6:
• Direcciones IPv6 únicas en formato hexadecimal de dos puntos (por ejemplo, 2001:0db8:85a3:0000:0000:8a2e:0370:7334).
• Direcciones IPv6 únicas en formato de compresión cero (por ejemplo, 2001:db8::1 para 2001:0db8:0000:0000:0000:0000:0000:0001).
• El CIDR IPv6 oscila entre 1 y 128 (por ejemplo, 2001:0db8::/32).
Para escribir varios valores, use esta sintaxis: "Value1","Value2",..."ValueN".
Límites de entrada para cada subtipo de lista (remitente, dirección URL, archivo o IP):
- Organizaciones sin Microsoft Defender para Office 365: el número máximo de entradas permitidas es 500 y el número máximo de entradas de bloque es 500.
- Organizaciones con Defender para Office 365 Plan 1: el número máximo de entradas permitidas es 1000 y el número máximo de entradas de bloque es 1000.
- Organizaciones con Defender para Office 365 Plan 2: el número máximo de entradas de permiso es 5000, y el número máximo de entradas de bloque es 10000.
El número máximo de caracteres en una entrada de archivo es 64 y el número máximo de caracteres en una entrada de dirección URL es 250.
No puede mezclar tipos de valor (remitente, dirección URL, archivo o IP) ni permitir y bloquear acciones en el mismo comando.
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).
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: | 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 establece la fecha de expiración de la entrada 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
Expiration
| 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 |
-ListSubType
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
El parámetro ListSubType especifica el subtipo de esta entrada. Los valores admitidos son:
- AdvancedDelivery: use este valor para las direcciones URL de simulación de suplantación de identidad (phishing). Para obtener más información, consulte Configuración de la directiva de entrega avanzada para simulaciones de phishing que no son de Microsoft y entrega de correo electrónico a buzones de correo 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 |
| 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 se va a agregar. Los valores admitidos son:
- FileHash
- Remitente
- Url
- IP
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 |
-LogExtraDetails
Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales
{{ Fill LogExtraDetails Description }}
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 |
-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 su uso en los siguientes escenarios:
- Con el interruptor de bloqueo.
- Con el modificador Permitir donde el valor del parámetro ListType es URL y el valor del parámetro ListSubType es AdvancedDelivery.
- Con el modificador Permitir donde el valor del parámetro ListType es IP.
No puedes usar este modificador con el parámetro ExpirationDate o RemoveAfter.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
NoExpiration
| 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.
Puede usar este parámetro con el modificador Permitir cuando el valor del parámetro ListType es Sender, FileHash o Url.
No puedes usar este parámetro con los parámetros ExpirationDate o NoExpirationDate.
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 |
-SubmissionID
Aplicable: Exchange Online, seguridad & cumplimiento, complemento de seguridad integrado para buzones locales
Este parámetro está reservado para uso interno de Microsoft.
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 |
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.