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/2021En 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:
- 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 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 |