Import-CMAADServerApplication

  • Referência
Módulo:
ConfigurationManager

Crie a definição do aplicativo de servidor Microsoft Entra no 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 esse cmdlet para importar o aplicativo de servidor de Microsoft Entra ID e defina-o para o site Configuration Manager. Ele pressupõe que um administrador do Azure já tenha criado o aplicativo no Microsoft Entra ID. Em Microsoft Entra ID, esse aplicativo é conhecido como um registro de aplicativo Web.

Para obter mais informações sobre como usar esse cmdlet para criar um CMG (gateway de gerenciamento de nuvem), confira notas de versão de 2010: gateway de gerenciamento de nuvem.

Para obter mais informações sobre Microsoft Entra aplicativos no Configuration Manager, consulte Configurar serviços do Azure.

Observação

Esse cmdlet pode funcionar com outros serviços do Azure, mas ele só é testado com a conexão de gerenciamento de nuvem para dar suporte ao CMG (gateway de gerenciamento de nuvem).

Exemplos

Exemplo 1

Neste exemplo, o primeiro comando cria uma variável datetime para 11/16/2021. O segundo comando usa essa variável de data como a data de validade da chave secreta, quando importa o aplicativo de servidor usando os detalhes fornecidos.

$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 o URI da ID do aplicativo na Microsoft Entra centro de administração. Esse valor precisa ser exclusivo em seu locatário Microsoft Entra. Ele está no token de acesso usado pelo Configuration Manager cliente para solicitar acesso ao serviço. O formato é semelhante ao https://ConfigMgrService.

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

-AppName

Especifique o nome amigável para o aplicativo. Esse valor é o nome de exibição no registro do aplicativo.

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

-AzureEnvironmentOption

Especifique se esse registro de aplicativo está na nuvem global do Azure (AzurePublicCloud) ou na nuvem Azure Governamental (AzureUSGovernmentCloud).

Type:AzureEnvironment
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientId

Especifique o valor de ID do aplicativo (cliente) do registro do aplicativo em Microsoft Entra ID. O formato é um GUID padrão.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-SecretKey

Especifique a chave secreta para este aplicativo conforme copiada do portal do Azure. Você copiou a chave secreta quando registrou o aplicativo em Microsoft Entra ID.

Type:SecureString
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecretKeyExpiry

Especifique a data em que a SecretKey expirará. Você configura esse valor ao criar a chave secreta do aplicativo no Microsoft Entra ID.

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

-TenantId

Especifique o GUID de seu locatário Microsoft Entra.

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

-TenantName

Especifique o nome do locatário Microsoft Entra.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

IResultObject