Set-AuthServer

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Set-AuthServer per configurare un server di autorizzazione che le applicazioni partner possono utilizzare per ottenere i token riconosciuti da Microsoft Exchange.

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

Sintassi

AuthMetadataUrl 

Set-AuthServer
    [-Identity] <AuthServerIdParameter>
    [-AuthMetadataUrl <String>]
    [-GraphBaseUrl <String>]
    [-TrustAnySSLCertificate]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Enabled <Boolean>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

NativeClientAuthServer 

Set-AuthServer
    [-Identity] <AuthServerIdParameter>
    [-AuthMetadataUrl <String>]
    [-IsDefaultAuthorizationEndpoint <Boolean>]
    [-TrustAnySSLCertificate]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Enabled <Boolean>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

RefreshAuthMetadata 

Set-AuthServer
    [-Identity] <AuthServerIdParameter>
    [-RefreshAuthMetadata]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Enabled <Boolean>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

AppSecret 

Set-AuthServer
    [-Identity] <AuthServerIdParameter>
    [-ApplicationIdentifier <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty]>]
    [-Enabled <Boolean>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Le applicazioni partner autorizzate da Exchange possono accedere alle proprie risorse dopo che sono state autenticate utilizzando l'autenticazione da server a server. Un'applicazione partner può eseguire l'autenticazione utilizzando token rilasciati automaticamente attendibili da Exchange o un server di autorizzazione considerato attendibile da Exchange. È possibile utilizzare il cmdlet New-AuthServer per creare un oggetto server di autorizzazione attendibile in Exchange, che consente di considerare attendibili i token emessi dal server di autorizzazione.

Utilizzare il cmdlet Set-AuthServer per abilitare o disabilitare il server di autorizzazione, modificare il parametro AuthMetadataUrl o aggiornare i metadati di autorizzazione.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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-AuthServer ACS -Enabled $false

Questo comando disabilita il server di autorizzazioni ACS.

Parametri

-ApplicationIdentifier

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Questo parametro è disponibile nell'aggiornamento dell'hotfix (HU) del 18 aprile 2025 per Exchange 2019 CU15 ed Exchange 2016 CU23.

{{ Fill ApplicationIdentifier Description }}

Proprietà dei parametri

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

Set di parametri

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

-AuthMetadataUrl

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

Il parametro AuthMetadataUrl consente di specificare l'URL del server di autorizzazione. Può essere l'AuthMetadataUrl dell'organizzazione di Exchange Online.

Proprietà dei parametri

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

Set di parametri

AuthMetadataUrl
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
NativeClientAuthServer
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 Server SE

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma 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, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone 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

-DomainController

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

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.

Proprietà dei parametri

Tipo:Fqdn
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

-DomainName

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Questo parametro è disponibile solo in Exchange Server 2016 (CU18 o versione successiva) ed Exchange Server 2019 (CU7 o versione successiva).

Il parametro NomeDominio collega un'organizzazione basata su cloud all'oggetto AuthServer corrispondente nell'ibrido di Exchange multi-tenant. Questo parametro usa la sintassi: "domain.onmicrosoft.com".

Ad esempio, se il valore DomainName è contoso.onmicrosoft.com, l'oggetto AuthServer è associato all'organizzazione basata su cloud contoso.

Proprietà dei parametri

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

Set di parametri

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

-Enabled

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

Il parametro Enabled consente di specificare se il server di autorizzazioni è abilitato. Solo i server di autorizzazioni abilitati possono emettere e accettare i token. La disabilitazione del server di autorizzazioni impedisce alle applicazioni partner configurate per l'utilizzo del server di autorizzazioni di ottenere un token.

Il parametro Enabled consente di specificare se il server di autorizzazioni è abilitato. I valori validi sono:

  • $true: i token di autorizzazione emessi dal server di autorizzazione vengono accettati. Questo è il valore predefinito
  • $false: Il server di autorizzazione non rilascia né accetta token di autorizzazione.

Proprietà dei parametri

Tipo:Boolean
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

-GraphBaseUrl

Applicabile: Exchange Server 2019, Exchange Server SE

{{ Fill GraphBaseUrl Description }}

Proprietà dei parametri

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

Set di parametri

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

-Identity

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

Il parametro Identity consente di specificare l'oggetto server di autorizzazione che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi in modo univoco il server di autorizzazione. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

Proprietà dei parametri

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

Set di parametri

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

-IsDefaultAuthorizationEndpoint

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

Il parametro IsDefaultAuthorizationEndpoint consente di specificare se il server è l'endpoint di autorizzazione predefinito. I valori validi sono:

$true: l'URL del server di autorizzazione viene annunciato alle applicazioni partner chiamanti e alle applicazioni che devono ottenere i token di accesso OAuth dal server di autorizzazione.

$false: L'URL del server di autorizzazione non viene annunciato. Il valore predefinito è $false.

Proprietà dei parametri

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

Set di parametri

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

-Name

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

Il parametro Name consente di specificare un nome univoco per l'oggetto server di autorizzazione. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Proprietà dei parametri

Tipo:String
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

-RefreshAuthMetadata

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

L'opzione RefreshAuthMetadata specifica se Exchange deve aggiornare i metadati di autenticazione dall'URL specificato. 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

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

-TrustAnySSLCertificate

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

L'opzione TrustAnySSLCertificate consente a Exchange di accettare certificati da autorità di certificazione (CA) non attendibili. Con questa opzione non è necessario specificare alcun valore.

Si consiglia di non utilizzare questa opzione in un ambiente di produzione.

Proprietà dei parametri

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

Set di parametri

AuthMetadataUrl
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
NativeClientAuthServer
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 Server SE

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. 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.