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 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
New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-SubmissionID <String>]
[<CommonParameters>] New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-SubmissionID <String>]
[<CommonParameters>] Description
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
New-TenantAllowBlockListItems -ListType Url -Block -Entries ~contoso.com~En este ejemplo se agrega una entrada de bloque 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 usamos 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" -NoExpirationEn este ejemplo se agrega una entrada de bloque de archivos para los archivos especificados que nunca expiran.
Ejemplo 3
New-TenantAllowBlockListItems -Allow -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -NoExpirationEn este ejemplo se agrega una entrada de permiso de dirección URL para la dirección URL de simulación de suplantación de identidad de terceros especificada sin expiración. Para obtener más información, vea Configurar la entrega de simulaciones de phishing de terceros a los usuarios y de mensajes no filtrados a los buzones de SecOps.
Parámetros
-Allow
El modificador Allow especifica que va a crear una entrada allow. No es necesario especificar un valor con este modificador.
No puede usar este modificador con el modificador Bloquear.
Nota: Consulte Permitir entradas en la lista de permitidos o bloques de inquilinos antes de intentar crear una entrada allow.
También puede usar entradas allow para direcciones URL de simulación de suplantación de identidad de terceros sin expiración. Para obtener más información, vea Configurar la entrega de simulaciones de phishing de terceros a los usuarios y de mensajes no filtrados a los buzones de SecOps.
| 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 Allow especifica que va a crear una entrada de bloque. No es necesario especificar un valor con este modificador.
No puede usar este modificador con el modificador Permitir.
| 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 los valores que desea agregar a la lista de permitidos o bloques de inquilinos en función del valor del parámetro ListType:
- FileHash: use el valor hash SHA256 del archivo. En Windows, puede encontrar el valor hash SHA256 ejecutando el siguiente comando en un símbolo del sistema:
certutil.exe -hashfile "<Path>\<Filename>" SHA256. Un valor de ejemplo es768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3. - Remitente: valor de dominio o dirección de correo electrónico. Por ejemplo,
contoso.comomichelle@contoso.com. - DIRECCIÓN URL: use nombres de host o direcciones IPv4 o IPv6. Los caracteres comodín (* 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 direcciones URL para la lista de permitidos o bloqueados de inquilinos.
Para especificar varios valores, use la sintaxis siguiente: "Value1","Value2",..."ValueN".
Para remitentes, archivos y direcciones URL, el número máximo de entradas permitidas para cada tipo es 500 y el número máximo de entradas de bloque para cada tipo es de 500 (1000 entradas en total para cada tipo).
El número máximo de caracteres de una entrada de archivo es 64 y el número máximo de caracteres de una entrada de dirección URL es de 250.
No puede combinar tipos de valor (archivo, remitente o dirección URL) ni permitir y bloquear acciones en el mismo comando.
En la mayoría de los casos, no puede modificar los valores de dirección URL, archivo o remitente después de crear la entrada. La única excepción es permitir entradas url para simulaciones de suplantación de identidad (ListType = URL, ListSubType = AdvancedDelivery).
| 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 |
-ListSubType
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 phishing. Para obtener más información, vea Configurar la entrega de simulaciones de phishing de terceros a los usuarios y de mensajes no filtrados a los buzones de SecOps.
- Inquilino: este es el valor predeterminado.
| 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 se va a agregar. Los valores admitidos son:
- FileHash
- Remitente
- Url
| 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 |
-LogExtraDetails
{{ Fill LogExtraDetails Description }}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, 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 su uso en los siguientes escenarios:
- Con el modificador Bloquear.
- Con el modificador Allow donde el valor del parámetro ListType es URL y 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 |
-SubmissionID
Este parámetro está reservado para uso interno de Microsoft.
| 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 |