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