New-AuthServer
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet New-AuthServer per creare un oggetto server di autorizzazione in Microsoft Exchange e specificare il relativo AuthMetadataUrl. Exchange rispetta i token emessi dal server di autorizzazione per l'accesso da parte di un'applicazione partner.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-AuthServer
[-Name] <String>
-AuthMetadataUrl <String>
[-TrustAnySSLCertificate]
[-Confirm]
[-DomainController <Fqdn>]
[-DomainName <MultiValuedProperty>]
[-Enabled <Boolean>]
[-WhatIf]
[<CommonParameters>] New-AuthServer
[-Name] <String>
-AuthMetadataUrl <String>
-Type <AuthServerType>
[-TrustAnySSLCertificate]
[-Confirm]
[-DomainController <Fqdn>]
[-DomainName <MultiValuedProperty>]
[-Enabled <Boolean>]
[-WhatIf]
[<CommonParameters>] New-AuthServer
[-Name] <String>
-Type <AuthServerType>
[-ApplicationIdentifier <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-DomainName <MultiValuedProperty>]
[-Enabled <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
Le applicazioni partner autorizzate da Exchange possono accedere alle risorse dopo l'autenticazione tramite l'autenticazione da server a server. Un'applicazione partner può eseguire l'autenticazione usando token auto-rilasciati attendibili da Exchange o usando un server di autorizzazione attendibile da Exchange.
È 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
New-AuthServer -Name WindowsAzureACS -AuthMetadataUrl https://accounts.accesscontrol.windows.net/contoso.onmicrosoft.com/metadata/json/1Questo comando crea un oggetto server di autorizzazione con le impostazioni specificate.
Parametri
-ApplicationIdentifier
Questo parametro è disponibile nell'aggiornamento hotfix (HU) del 18 aprile 2025 per Exchange 2019 CU15 ed Exchange 2016 CU23.
{{ Fill ApplicationIdentifier Description }}
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2016, Exchange Server 2019 |
-AuthMetadataUrl
Il parametro AuthMetadataUrl specifica l'URL per il server di autorizzazione di Microsoft 365 per l'organizzazione basata sul cloud.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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-*) 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.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
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.
| Tipo: | Fqdn |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainName
{{ Fill DomainName Description }}
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2016, Exchange Server 2019 |
-Enabled
Il parametro Enabled consente di specificare se il server di autorizzazioni è abilitato. I valori validi sono:
- $true: vengono accettati i token di autorizzazione rilasciati dal server di autorizzazione. Questo è il valore predefinito
- $false: i token di autorizzazione rilasciati dal server di autorizzazione non vengono accettati.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
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 (").
| Tipo: | String |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TrustAnySSLCertificate
Il commutatore TrustAnySSLCertificate consente a Exchange di accettare certificati da autorità di certificazione non attendibili. Con questa opzione non è necessario specificare alcun valore.
Si consiglia di non utilizzare questa opzione in un ambiente di produzione.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Type
Il parametro Type consente di specificare il tipo di token di autorizzazione rilasciati dal server di autorizzazione. I valori validi sono:
- ADFS
- AzureAD
- MicrosoftACS
| Tipo: | AuthServerType |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, 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.