New-AuthServer

Módulo:
Exchange PowerShell

Este cmdlet solo está disponible en el entorno local de Exchange.

Utilice el cmdlet New-AuthServer para crear un objeto de servidor de autorización en Microsoft Exchange y especifique su AuthMetadataUrl. Tokens de honor de Exchange emitidos por el servidor de autorización para el acceso de una aplicación asociada.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

AuthMetadataUrl 

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

NativeClientAuthServer 

New-AuthServer
    [-Name] <String>
    -AuthMetadataUrl <String>
    -Type <AuthServerType>
    [-TrustAnySSLCertificate]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Enabled <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

AppSecret 

New-AuthServer
    [-Name] <String>
    -Type <AuthServerType>
    [-ApplicationIdentifier <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Enabled <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

Las aplicaciones asociadas autorizadas por Exchange pueden acceder a sus recursos después de autenticarse mediante la autenticación de servidor a servidor. Una aplicación de asociado puede autenticarse mediante tokens autoemitidos de confianza por Exchange o mediante un servidor de autorización de confianza de Exchange.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

New-AuthServer -Name WindowsAzureACS -AuthMetadataUrl https://accounts.accesscontrol.windows.net/contoso.onmicrosoft.com/metadata/json/1

Este comando crea un objeto de servidor de autorización con la configuración especificada.

Parámetros

-ApplicationIdentifier

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro está disponible en la actualización de revisión (HU) del 18 de abril de 2025 para Exchange 2019 CU15 y Exchange 2016 CU23.

{{ Rellenar descripción de ApplicationIdentifier }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AppSecret
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AuthMetadataUrl

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

El parámetro AuthMetadataUrl especifica la dirección URL del servidor de autorización de Microsoft 365 para su organización basada en la nube.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AuthMetadataUrl
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
NativeClientAuthServer
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

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

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

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

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Propiedades de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainName

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange Server 2016 (CU18 o superior) y Exchange Server 2019 (CU7 o superior).

El parámetro DomainName vincula una organización basada en la nube con el objeto AuthServer correspondiente en el híbrido de Exchange de varios inquilinos. Este parámetro utiliza la sintaxis: "domain.onmicrosoft.com".

Por ejemplo, si el valor DomainName es contoso.onmicrosoft.com, el objeto AuthServer se asocia a la organización basada en la nube de Contoso.

Propiedades de parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Enabled

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

El parámetro Enabled especifica si se ha habilitado el servidor de autorización. Los valores admitidos son:

  • $true: Se aceptan los tokens de autorización emitidos por el servidor de autorización. Este valor es el predeterminado
  • $false: No se aceptan los tokens de autorización emitidos por el servidor de autorización.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GraphBaseUrl

Aplicable: Exchange Server 2019, Exchange Server SE

{{ Fill GraphBaseUrl Description }}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AuthMetadataUrl
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

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

El parámetro Name especifica un nombre único para el objeto del servidor de autorización. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas (").

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TrustAnySSLCertificate

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

El conmutador TrustAnySSLCertificate permite que Exchange acepte certificados de entidades emisoras de certificados (CA) que no sean de confianza. No es necesario especificar un valor con este modificador.

No recomendamos usar este interruptor en un entorno de producción.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AuthMetadataUrl
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
NativeClientAuthServer
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Type

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

El parámetro Type especifica el tipo de tokens de autorización emitidos por el servidor de autorización. Los valores admitidos son:

  • ADFS
  • Azure AD
  • Facebook
  • LinkedIn
  • MicrosoftACS

Propiedades de parámetro

Tipo:AuthServerType
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NativeClientAuthServer
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
AppSecret
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.