Import-CMAADServerApplication

  • Referencia
Módulo:
ConfigurationManager

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

Syntax

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 ha creado la aplicación en Microsoft Entra identificador. 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 Microsoft Entra aplicaciones 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.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppName

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

Type:String
Aliases:ApplicationName
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AzureEnvironmentOption

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

Type:AzureEnvironment
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecretKey

Especifique la clave secreta de esta aplicación como copiada de la Azure Portal. Copió la clave secreta al registrar la aplicación en Microsoft Entra identificador.

Type:SecureString
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 identificador.

Type:DateTime
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Especifique el GUID del inquilino de Microsoft Entra.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantName

Especifique el nombre del inquilino de Microsoft Entra.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

IResultObject