Import-CMAADClientApplication

Configuration Manager で Microsoft Entra クライアント アプリ定義を作成します。

構文

Import-CMAADClientApplication
      -AppName <String>
      -ClientId <String>
      -ServerApp <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Import-CMAADClientApplication
      -AppName <String>
      -ClientId <String>
      -TenantId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットを使用して、Microsoft Entra ID からクライアント アプリをインポートし、Configuration Manager サイト用に定義します。 Azure 管理者が Microsoft Entra ID でアプリを既に作成していることを前提としています。 Microsoft Entra ID では、このアプリは ネイティブ アプリの登録と呼ばれます。

このコマンドレットを使用してクラウド管理ゲートウェイ (CMG) を作成する方法の詳細については、「 2010 リリース ノート: クラウド管理ゲートウェイ」を参照してください。

Configuration Manager での Microsoft Entra アプリの詳細については、「 Azure サービスの構成」を参照してください。

注:

このコマンドレットは他の Azure サービスと連携できますが、クラウド管理ゲートウェイ (CMG) をサポートするために クラウド管理 接続でのみテストされます。

例 1: テナント ID に基づいてクライアント アプリをインポートする

Import-CMAADClientApplication -TenantId "05a349fa-298a-4427-8771-9efcdb73431e" -AppName "CmgClientApp" -ClientId "cf114f48-88db-4829-ac45-0c186e86dbf6"

例 2: サーバー アプリに基づいてクライアント アプリをインポートする

$serverApp = Get-CMAADApplication -TenantName "Contoso" -AppType ServerApplication -AppName "CmgServerApp"

Import-CMAADClientApplication -ServerApp $serverApp -AppName "CmgClientApp" -ClientId "cf114f48-88db-4829-ac45-0c186e86dbf6"

パラメーター

-AppName

Microsoft Entra ID でアプリの名前を指定します。

型:String
Aliases:ApplicationName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClientId

Microsoft Entra ID でアプリ登録の アプリケーション (クライアント) ID 値を指定します。 形式は標準の GUID です。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerApp

サーバー アプリのオブジェクトを指定します。 サーバー アプリを取得するには、 Get-CMAADApplication コマンドレットを 使用します。

型:IResultObject
Aliases:ServerApplication
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TenantId

Microsoft Entra テナントの GUID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

IResultObject