Condividi tramite


Test-OAuthConnectivity

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.

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

Default (impostazione predefinita).

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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

L'opzione AppOnly specifica che il cmdlet esegue l'autenticazione nel servizio specificato come Exchange senza alcun contesto utente. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Mailbox

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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\Nome utente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

Proprietà dei parametri

Tipo:MailboxIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ReloadConfig

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Service

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

  • EWS
  • AutoD
  • Generale

Proprietà dei parametri

Tipo:ModServiceType
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TargetUri

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Proprietà dei parametri

Tipo:Uri
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UseCachedToken

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

L'opzione UseCachedToken specifica che OAuth tenta di usare un token di autorizzazione esistente memorizzato nella cache. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

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.