Condividi tramite


Set-TenantAllowBlockListItems

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-TenantAllowBlockListItems per modificare le voci nell'elenco tenant consentiti/bloccati nel portale di Microsoft 365 Defender.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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>]

Descrizione

Nella maggior parte dei casi, non è possibile modificare i valori url, file o mittente di una voce esistente. L'unica eccezione è consentire le voci url per le simulazioni di phishing (Action = Allow, ListType = URL e ListSubType = AdvancedDelivery). Per altre informazioni sull'abilitazione degli URL per le simulazioni di phishing, vedere Configurare il recapito di simulazioni di phishing di terze parti agli utenti e messaggi non filtrati alle cassette postali SecOps.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()

In questo esempio viene modificata la data di scadenza della voce specificata.

Esempio 2

Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021

In questo esempio viene modificata la data di scadenza della voce URL allow per l'URL di simulazione di phishing di terze parti specificato.

Parametri

-Allow

L'opzione Consenti specifica che si sta modificando una voce allow. Con questa opzione non è necessario specificare alcun valore.

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

L'opzione Blocca specifica che si sta modificando una voce di blocco. Con questa opzione non è necessario specificare alcun valore.

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

Il parametro Entries consente di specificare le voci che si desidera modificare in base al valore del parametro ListType. I valori validi sono:

  • FileHash: valore hash del file SHA256 esatto.
  • Domini del mittente e indirizzi di posta elettronica: il valore esatto del dominio o dell'indirizzo di posta elettronica.
  • URL: valore url esatto.

Questo valore viene visualizzato nella proprietà Value della voce nell'output del cmdlet Get-TenantAllowBlockListItems.

Non è possibile combinare tipi di valore (file, mittente o URL) né consentire e bloccare azioni nello stesso comando.

Non è possibile usare questo parametro con il parametro 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

Il parametro ExpirationDate filtra i risultati in base alla data di scadenza in Coordinated Universal Time (UTC).

Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:

  • Specificare il valore di data/ora in formato UTC: ad esempio, "2021-05-06 14:30:00z".
  • Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in formato UTC: ad esempio, (Get-Date "5/6/2020 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.

Non è possibile usare questo parametro con l'opzione 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

Il parametro Ids consente di specificare le voci che si desidera modificare. Questo valore viene visualizzato nella proprietà Identity nell'output del cmdlet Get-TenantAllowBlockListItems.

Un valore di esempio per questo parametro è RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.

Non è possibile usare questo parametro con il parametro 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

Il parametro ListSubType specifica ulteriormente la voce da modificare. I valori validi sono:

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

Il parametro ListType consente di specificare il tipo di voce da modificare. I valori validi sono:

  • FileHash
  • Mittente
  • Url

Usare il parametro Entries o Ids con questo parametro per identificare la voce stessa.

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

L'opzione NoExpiration specifica che la voce non deve mai scadere. Con questa opzione non è necessario specificare alcun valore.

Questa opzione è disponibile per l'uso con voci di blocco o con voci url allow in cui il valore del parametro ListSubType è AdvancedDelivery.

Non è possibile usare questa opzione con il parametro 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

Il parametro Notes consente di specificare informazioni aggiuntive sull'oggetto. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

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

L'opzione OutputJson specifica se restituire tutte le voci in un singolo valore JSON. Con questa opzione non è necessario specificare alcun valore.

Usare questa opzione per impedire l'interruzione del comando nella prima voce che contiene un errore di sintassi.

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