Test-IRMConfiguration
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 Test-IRMConfiguration per verificare la configurazione e la funzionalità di Information Rights Management (IRM).
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Test-IRMConfiguration
[[-Identity] <OrganizationIdParameter>]
-Sender <SmtpAddress>
[-Confirm]
[-DomainController <Fqdn>]
[-Recipient <SmtpAddress[]>]
[-RMSOnline]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Test-IRMConfiguration esegue una serie di passaggi per testare la configurazione e le funzionalità di IRM, tra cui la disponibilità di un server Active Directory Rights Management Services (AD RMS), il prelicensing e la decrittografia del report journal. Nelle organizzazioni Exchange Online controlla la connettività a RMS Online e ottiene e convalida il dominio di pubblicazione attendibile (TPD) dell'organizzazione.
È 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
Test-IRMConfiguration -Sender adams@contoso.com
In questo esempio viene testata la configurazione IRM in Exchange locale per i messaggi inviati dal mittente adams@contoso.com.
Esempio 2
Test-IRMConfiguration -Sender chris@fabrikam.com -Recipient michell@fourthcoffee.com
Questo esempio testa la configurazione IRM nel servizio basato sul cloud per i messaggi inviati da chris@fabrikam.com a michell@fourthcoffee.com.
Parametri
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false
. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type: | SwitchParameter |
Aliases: | cf |
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, Exchange Online Protection |
-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
Questo parametro è disponibile solo in Exchange locale.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | OrganizationIdParameter |
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 |
-Recipient
Il parametro Recipient consente di specificare l'indirizzo di posta elettronica del destinatario da testare. È possibile indicare più indirizzi di posta elettronica separati da virgole.
Questo parametro è obbligatorio nel servizio basato sul cloud.
In Exchange locale, se non si usa questo parametro, l'indirizzo del mittente specificato dal parametro Sender viene usato per il valore di questo parametro.
Type: | SmtpAddress[] |
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, Exchange Online Protection |
-RMSOnline
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione RMSOnline specifica se testare la connettività da Exchange Online a RMS Online, ottenere il TPD dell'organizzazione Exchange Online e testarne la validità. 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, Exchange Online Protection |
-Sender
Il parametro Sender consente di specificare l'indirizzo di posta elettronica del mittente da testare.
Type: | SmtpAddress |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Aliases: | wi |
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, Exchange Online Protection |
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.