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 dall Microsoft Entra ID e definirla per il sito Configuration Manager. Si presuppone che un amministratore di Azure abbia già creato l'app nell 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 Microsoft Entra. Questo valore deve essere univoco nel tenant Microsoft Entra. Si tratta del token di accesso usato dal client Configuration Manager per richiedere l'accesso al servizio. Il formato è simile a https://ConfigMgrService.

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

-AppName

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

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

-AzureEnvironmentOption

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

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

-ClientId

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

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-SecretKey

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

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

-SecretKeyExpiry

Specificare la data di scadenza di SecretKey . Questo valore viene configurato quando si crea la chiave privata per l'app nell Microsoft Entra ID.

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

-TenantId

Specificare il GUID del tenant Microsoft Entra.

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

-TenantName

Specificare il nome del tenant Microsoft Entra.

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

-WhatIf

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

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

Input

None

Output

IResultObject