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/2021In 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:
- AdvancedDelivery: usare questo valore per gli URL di simulazione del phishing. Per altre informazioni, vedere Configura la consegna di simulazioni di phishing di terze parti agli utenti e messaggi non filtrati alle caselle di posta di SecOps.
- Tenant: questo è il valore predefinito.
| 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 |