Test-OAuthConnectivity

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Il cmdlet Test-OAuthConnectivity consente di verificare l'autenticazione OAuth nelle applicazioni partner di un utente.

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

Sintassi

Test-OAuthConnectivity
    -Service <ModServiceType>
    -TargetUri <Uri>
    [-AppOnly]
    [-Confirm]
    [-Mailbox <MailboxIdParameter>]
    [-ReloadConfig]
    [-UseCachedToken]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Le applicazioni SharePoint, Lync e Skype for Business partner vengono create automaticamente nelle distribuzioni di Exchange locali. Affinché il cmdlet Test-OAuthConnectivity abbia esito positivo per altre applicazioni partner nelle distribuzioni locali, è prima necessario creare l'applicazione partner usando lo script Configure-EnterprisePartnerApplication.ps1 disponibile nella cartella %ExchangeInstallPath%Scripts ($env:ExchangeInstallPath\Scripts in PowerShell).

È 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-OAuthConnectivity -Service EWS -TargetUri https://cas.contoso.com/ews/ -Mailbox "Gurinder Singh"

Questo esempio testa la connettività OAuth con Exchange per Gurinder Singh.

Parametri

-AppOnly

Il parametro AppOnly consente di specificare che il cmdlet eseguirà l'autenticazione al servizio specificato come Exchange senza alcun contesto utente. 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

-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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

Il parametro Mailbox consente di specificare la cassetta postale per cui si desidera testare la connettività OAuth nell'applicazione partner specificata. È 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ReloadConfig

Il parametro ReloadConfig consente di ricaricare tutte le impostazioni di configurazione dagli oggetti di configurazione di Exchange. Con questa opzione non è necessario specificare alcun valore.

Se non si utilizza questo parametro, vengono utilizzate le impostazione di configurazione memorizzate nella cache.

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

-Service

Il parametro Service consente di specificare l'applicazione partner. I valori validi per questo parametro sono:

  • EWS
  • AutoD
  • Generale
Type:ModServiceType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetUri

Il parametro TargetUri consente di specificare l'URL per il servizio con cui si desidera verificare la connettività OAuth.

Type:Uri
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-UseCachedToken

Il parametro UseCachedToken consente di specificare che OAuth tenterà di utilizzare un token di autorizzazione esistente memorizzato nella cache. 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

-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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.