Condividi tramite

Import-CMAADServerApplication

  • Riferimento
Modulo:
ConfigurationManager

Creare la definizione dell'app server Microsoft Entra in Configuration Manager.

Sintassi

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

Descrizione

Usare questo cmdlet per importare l'app server da Microsoft Entra ID e definirla per il sito di Configuration Manager. Si presuppone che un amministratore di Azure abbia già creato l'app in Microsoft Entra ID. In Microsoft Entra ID questa app è nota come registrazione di un'app Web .

Per altre informazioni su come usare questo cmdlet per creare un gateway di gestione cloud, vedere note sulla versione 2010: Gateway di gestione cloud.

Per altre informazioni sulle app Microsoft Entra in Configuration Manager, vedere Configurare i servizi di Azure.

Nota

Questo cmdlet può funzionare con altri servizi di Azure, ma viene testato solo con la connessione di gestione cloud per supportare cloud management gateway (CMG).

Esempio

Esempio 1

In questo esempio il primo comando crea una variabile datetime per 11/16/2021. Il secondo comando usa questa variabile di data come data di scadenza della chiave privata, quando importa l'app server usando i dettagli forniti.

$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

Parametri

-AppIdUri

Specificare l'URI id applicazione della voce di registrazione dell'app nell'interfaccia di amministrazione di Microsoft Entra. Questo valore deve essere univoco nel tenant di Microsoft Entra. Si tratta del token di accesso usato dal client di Configuration Manager per richiedere l'accesso al servizio. Il formato è simile a https://ConfigMgrService.

Tipo:Uri
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AppName

Specificare il nome descrittivo per l'app. Questo valore è il nome visualizzato nella registrazione dell'app.

Tipo:String
Alias:ApplicationName
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AzureEnvironmentOption

Specificare se la registrazione dell'app si trova nel cloud di Azure globale (AzurePublicCloud) o nel cloud di Azure per enti pubblici (AzureUSGovernmentCloud).

Tipo:AzureEnvironment
Valori accettati:AzurePublicCloud, AzureUSGovernmentCloud
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClientId

Specificare il valore dell'ID applicazione (client) della registrazione dell'app in Microsoft Entra ID. Il formato è un GUID standard.

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SecretKey

Specificare la chiave privata per questa app copiata dal portale di Azure. La chiave privata è stata copiata quando è stata registrata l'app in Microsoft Entra ID.

Tipo:SecureString
Posizione:4
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SecretKeyExpiry

Specificare la data di scadenza di SecretKey . You configure this value when you create the secret key for the app in Microsoft Entra ID.

Tipo:DateTime
Posizione:5
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TenantId

Specificare il GUID del tenant di Microsoft Entra.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TenantName

Specificare il nome del tenant di Microsoft Entra.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject