Freigeben über

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 der Microsoft Entra-ID zu importieren und für den Configuration Manager-Standort 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 zu 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. Sie befindet sich im Zugriffstoken, das vom Configuration Manager-Client zum Anfordern des Zugriffs auf den Dienst verwendet wird. Das Format ähnelt dem Format https://ConfigMgrService.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AppName

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

Typ:String
Aliase:ApplicationName
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AzureEnvironmentOption

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

Typ:AzureEnvironment
Zulässige Werte:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClientId

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

Typ:String
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SecureString
Position:4
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:DateTime
Position:5
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TenantId

Geben Sie die GUID Ihres Microsoft Entra-Mandanten an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TenantName

Geben Sie den Namen Ihres Microsoft Entra-Mandanten an.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject