Get-InboxRule
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Utilizzare il cmdlet Get-InboxRule per visualizzare le proprietà delle regole della posta in arrivo. Le regole della Posta in arrivo vengono utilizzate per l'elaborazione dei messaggi in Posta in arrivo in base alle condizioni specificate e per intraprendere un'azione come lo spostamento di un messaggio in una cartella specificata o l'eliminazione di un messaggio.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-InboxRule
[[-Identity] <InboxRuleIdParameter>]
[-BypassScopeCheck]
[-DescriptionTimeFormat <String>]
[-DescriptionTimeZone <ExTimeZoneValue>]
[-DomainController <Fqdn>]
[-IncludeHidden]
[-Mailbox <MailboxIdParameter>]
[-SweepRules]
[<CommonParameters>] Descrizione
È 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.
Nota: questo cmdlet non funziona per i membri di View-Only gruppo di ruoli Gestione organizzazione in Exchange Online o il ruolo Lettore globale in Azure Active Directory.
Esempio
Esempio 1
Get-InboxRule -Mailbox Joe@Contoso.comIn questo esempio vengono recuperate tutte le regole posta in arrivo per la cassetta postale Joe@Contoso.com.
Esempio 2
Get-InboxRule "ReceivedLastYear" -Mailbox joe@contoso.com -DescriptionTimeFormat "mm/dd/yyyy" -DescriptionTimeZone "Pacific Standard Time"In questo esempio viene recuperata la regola Posta in arrivo ReceivedLastYear dalla cassetta postale joe@contoso.com in cui è stato impostato il parametro ReceivedBeforeDate al momento della creazione della regola. In questo esempio, i parametri DescriptionTimeFormat e DescriptionTimeZone vengono utilizzati per indicare la formattazione dell'ora e del fuso orario utilizzata nella proprietà di Description della regola.
Parametri
-BypassScopeCheck
L'opzione BypassScopeCheck consente di specificare se si desidera ignorare il controllo dell'ambito per l'utente che esegue il comando. 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 Server 2016, Exchange Server 2019, Exchange Online |
-DescriptionTimeFormat
Il parametro DescriptionTimeFormat consente di specificare il formato per i valori di ora nella descrizione della regola. Ad esempio:
mm/gg/aaaa, dove mm è il mese a 2 cifre, dd è il giorno a 2 cifre e aaaa è l'anno a 4 cifre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DescriptionTimeZone
Il parametro DescriptionTimeZone consente di specificare il fuso orario usato per i valori di ora nella descrizione della regola.
$false: la regola o il criterio non sono abilitati.
Per visualizzare i valori disponibili, eseguire il comando seguente: $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display.
Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette ("). Il valore predefinito è l'impostazione del fuso orario del server Exchange.
| Type: | ExTimeZoneValue |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare la regola Posta in arrivo che si desidera visualizzare. È possibile utilizzare qualsiasi valore che identifichi la regola in modo univoco. Ad esempio:
- Nome
- Proprietà RuleIdentity (ad esempio, 16752869479666417665).
- Exchange Online:
MailboxAlias\RuleIdentity(ad esempio,rzaher\16752869479666417665). - Exchange locale:
MailboxCanonicalName\RuleIdentity(ad esempio,contoso.com/Users/Rick Zaher\16752869479666417665).
| Type: | InboxRuleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeHidden
L'opzione IncludeHidden specifica se includere le regole nascoste della posta in arrivo nei risultati. 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
Il parametro Mailbox consente di specificare la cassetta postale che contiene la regola Posta in arrivo. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SweepRules
Questo parametro è disponibile solo in Exchange locale.
L'opzione SweepRules specifica se restituire solo le regole Sweep nei risultati. Con questa opzione non è necessario specificare alcun valore.
Le regole di sweep vengono eseguite a intervalli regolari per mantenere pulita la posta in arrivo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.