Import-CMAADClientApplication

  • リファレンス
モジュール:
ConfigurationManager

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 でアプリの名前を指定します。

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

-ClientId

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

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-ServerApp

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

Type:IResultObject
Aliases:ServerApplication
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

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

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

-WhatIf

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

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

入力

None

出力

IResultObject