Import-CMAADServerApplication

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie die Microsoft Entra-Server-App-Definition in 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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um die Server-App aus Microsoft Entra ID zu importieren und für die Configuration Manager Website zu definieren. Es wird davon ausgegangen, dass die App bereits von einem Azure-Administrator in Microsoft Entra ID erstellt wurde. In Microsoft Entra-ID wird diese App als Web-App-Registrierung bezeichnet.

Weitere Informationen zur Verwendung dieses Cmdlets zum Erstellen eines Cloudverwaltungsgateways (CMG) finden Sie in den Versionshinweisen 2010: Cloudverwaltungsgateway.

Weitere Informationen zum Microsoft Entra Apps in Configuration Manager finden Sie unter Konfigurieren von Azure-Diensten.

Hinweis

Dieses Cmdlet funktioniert möglicherweise mit anderen Azure-Diensten, wird aber nur mit der Cloudverwaltungsverbindung getestet, um das Cloudverwaltungsgateway (CMG) zu unterstützen.

Beispiele

Beispiel 1

In diesem Beispiel erstellt der erste Befehl eine datetime-Variable für 11/16/2021. Der zweite Befehl verwendet diese Datumsvariable als Ablaufdatum des geheimen Schlüssels, wenn die Server-App mithilfe der angegebenen Details importiert wird.

$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

Parameter

-AppIdUri

Geben Sie den Anwendungs-ID-URI des App-Registrierungseintrags im Microsoft Entra Admin Center an. Dieser Wert muss in Ihrem Microsoft Entra Mandanten eindeutig sein. Es befindet sich im Zugriffstoken, das vom Configuration Manager-Client verwendet wird, um Zugriff auf den Dienst anzufordern. Das Format ähnelt dem Format https://ConfigMgrService.

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

-AppName

Geben Sie den Anzeigenamen für die App an. Dieser Wert ist der Anzeigename in der App-Registrierung.

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

-AzureEnvironmentOption

Geben Sie an, ob sich diese App-Registrierung in der globalen Azure-Cloud (AzurePublicCloud) oder in der Azure Government Cloud (AzureUSGovernmentCloud) befindet.

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

-ClientId

Geben Sie den Wert der Anwendungs-ID (Client) der App-Registrierung in Microsoft Entra-ID an. Das Format ist eine Standard-GUID.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-SecretKey

Geben Sie den geheimen Schlüssel für diese App an, wie er aus dem Azure-Portal kopiert wurde. Sie haben den geheimen Schlüssel kopiert, als Sie die App in Microsoft Entra ID registriert haben.

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

-SecretKeyExpiry

Geben Sie das Datum an, an dem der SecretKey abläuft. Sie konfigurieren diesen Wert, wenn Sie den geheimen Schlüssel für die App in Microsoft Entra ID erstellen.

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

-TenantId

Geben Sie die GUID Ihres Microsoft Entra Mandanten an.

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

-TenantName

Geben Sie den Namen Ihres Microsoft Entra Mandanten an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

None

Ausgaben

IResultObject