Compartir a través de


Import-CMAADServerApplication

Cree la definición de la aplicación de servidor Microsoft Entra en Configuration Manager.

Sintaxis

Import-CMAADServerApplication
      [-AppIdUri <Uri>]
      [-AppName] <String>
      [-AzureEnvironmentOption <AzureEnvironment>]
      [-ClientId] <String>
      [-SecretKey] <SecureString>
      [-SecretKeyExpiry] <DateTime>
      [-TenantId] <String>
      [-TenantName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use este cmdlet para importar la aplicación de servidor desde microsoft Entra ID y definirla para el sitio de Configuration Manager. Se supone que un administrador de Azure ya creó la aplicación en Microsoft Entra ID. En Microsoft Entra ID, esta aplicación se conoce como registro de aplicación web .

Para obtener más información sobre cómo usar este cmdlet para crear una puerta de enlace de administración en la nube (CMG), consulte las notas de la versión 2010: Cloud Management Gateway.

Para obtener más información sobre las aplicaciones de Microsoft Entra en Configuration Manager, consulte Configuración de servicios de Azure.

Nota:

Este cmdlet podría funcionar con otros servicios de Azure, pero solo se prueba con la conexión de administración en la nube para admitir cloud management gateway (CMG).

Ejemplos

Ejemplo 1

En este ejemplo, el primer comando crea una variable datetime para 11/16/2021. El segundo comando usa esta variable de fecha como fecha de expiración de clave secreta, cuando importa la aplicación de servidor con los detalles proporcionados.

$date = [datetime]::parseexact("11/16/2021", 'MM/dd/yyyy', $null)

Import-CMAADServerApplication -TenantName "Contoso" -TenantId "05a349fa-298a-4427-8771-9efcdb73431e" -AppName "CmgServerApp" -ClientId "7078946d-fc1c-43b7-8dee-dd6e6b00d783" -SecretKey "1uXGR^!0@Cjas6qI*J02ZeS&&zY19^hC*9" -SecretKeyExpiry $date

Parámetros

-AppIdUri

Especifique el URI del identificador de aplicación de la entrada de registro de la aplicación en el Centro de administración de Microsoft Entra. Este valor debe ser único en el inquilino de Microsoft Entra. Está en el token de acceso que usa el cliente de Configuration Manager para solicitar acceso al servicio. El formato es similar a https://ConfigMgrService.

Tipo:Uri
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AppName

Especifique el nombre descriptivo de la aplicación. Este valor es el nombre para mostrar en el registro de la aplicación.

Tipo:String
Alias:ApplicationName
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AzureEnvironmentOption

Especifique si este registro de aplicaciones está en la nube global de Azure (AzurePublicCloud) o en la nube de Azure Government (AzureUSGovernmentCloud).

Tipo:AzureEnvironment
Valores aceptados:AzurePublicCloud, AzureUSGovernmentCloud
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ClientId

Especifique el valor del identificador de aplicación (cliente) del registro de la aplicación en Microsoft Entra ID. El formato es un GUID estándar.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecretKey

Especifique la clave secreta de esta aplicación como copiada de Azure Portal. Copió la clave secreta cuando registró la aplicación en Microsoft Entra ID.

Tipo:SecureString
Posición:4
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecretKeyExpiry

Especifique la fecha en que expirará SecretKey . Este valor se configura al crear la clave secreta para la aplicación en Microsoft Entra ID.

Tipo:DateTime
Posición:5
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TenantId

Especifique el GUID del inquilino de Microsoft Entra.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TenantName

Especifique el nombre del inquilino de Microsoft Entra.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

IResultObject