Import-CMAADServerApplication

  • Referência
Módulo:
ConfigurationManager

Crie a definição da aplicação do servidor Microsoft Entra no Configuration Manager.

Sintaxe

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

Description

Utilize este cmdlet para importar a aplicação de servidor do Microsoft Entra ID e defina-a para o site do Configuration Manager. Assume que um administrador do Azure já criou a aplicação no Microsoft Entra ID. No Microsoft Entra ID, esta aplicação é conhecida como um registo de aplicação Web .

Para obter mais informações sobre como utilizar este cmdlet para criar um gateway de gestão da cloud (CMG), veja Notas de versão de 2010: Gateway de gestão da cloud.

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

Observação

Este cmdlet pode funcionar com outros serviços do Azure, mas só é testado com a ligação de gestão da Cloud para suportar o gateway de gestão da cloud (CMG).

Exemplos

Exemplo 1

Neste exemplo, o primeiro comando cria uma variável datetime para 11/16/2021. O segundo comando utiliza esta variável de data como a data de expiração da chave secreta, quando importa a aplicação do servidor com 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 do ID da Aplicação da entrada de registo de aplicações no centro de administração do Microsoft Entra. Este valor tem de ser exclusivo no seu inquilino do Microsoft Entra. Está no token de acesso utilizado pelo cliente do Configuration Manager para pedir acesso ao serviço. O formato é semelhante a https://ConfigMgrService.

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AppName

Especifique o nome amigável da aplicação. Este valor é o nome a apresentar no registo da aplicação.

Tipo:String
Aliases:ApplicationName
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AzureEnvironmentOption

Especifique se este registo de aplicações está na cloud global do Azure (AzurePublicCloud) ou na cloud do Azure Government (AzureUSGovernmentCloud).

Tipo:AzureEnvironment
Valores aceitos:AzurePublicCloud, AzureUSGovernmentCloud
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClientId

Especifique o valor do ID da Aplicação (cliente) do registo da aplicação no ID do Microsoft Entra. O formato é um GUID padrão.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecretKey

Especifique a chave secreta para esta aplicação como copiada do portal do Azure. Copiou a chave secreta quando registou a aplicação no Microsoft Entra ID.

Tipo:SecureString
Cargo:4
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecretKeyExpiry

Especifique a data em que a Chave Secreta irá expirar. Configura este valor quando cria a chave secreta para a aplicação no Microsoft Entra ID.

Tipo:DateTime
Cargo:5
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantId

Especifique o GUID do seu inquilino do Microsoft Entra.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantName

Especifique o nome do seu inquilino do Microsoft Entra.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject