次の方法で共有


Import-CMAADServerApplication

Configuration Manager で Microsoft Entra サーバー アプリ定義を作成します。

構文

Import-CMAADServerApplication
      [-AppIdUri <Uri>]
      [-AppName] <String>
      [-AzureEnvironmentOption <AzureEnvironment>]
      [-ClientId] <String>
      [-SecretKey] <SecureString>
      [-SecretKeyExpiry] <DateTime>
      [-TenantId] <String>
      [-TenantName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

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

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

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

注:

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

例 1

この例では、最初のコマンドによって、 11/16/2021の datetime 変数が作成されます。 2 番目のコマンドでは、指定された詳細を使用してサーバー アプリをインポートするときに、この日付変数を秘密キーの有効期限として使用します。

$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

パラメーター

-AppIdUri

Microsoft Entra 管理センターで、アプリ登録エントリの アプリケーション ID URI を 指定します。 この値は、Microsoft Entra テナントで一意である必要があります。 これは、Configuration Manager クライアントがサービスへのアクセスを要求するために使用するアクセス トークン内にあります。 形式は 次のようになります。 https://ConfigMgrService.

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

-AppName

アプリのフレンドリ名を指定します。 この値は、アプリ登録の表示名です。

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

-AzureEnvironmentOption

このアプリの登録がグローバル Azure クラウド (AzurePublicCloud)、または Azure Government クラウド (AzureUSGovernmentCloud) のいずれにあるかを指定します。

型:AzureEnvironment
指定可能な値:AzurePublicCloud, AzureUSGovernmentCloud
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClientId

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

型:String
配置:3
規定値: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

-SecretKey

Azure portal からコピーしたこのアプリの秘密キーを指定します。 Microsoft Entra ID でアプリを登録したときに、シークレット キーをコピーしました。

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

-SecretKeyExpiry

SecretKey の有効期限が切れる日付を指定します。 この値は、Microsoft Entra ID でアプリの秘密キーを作成するときに構成します。

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

-TenantId

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

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

-TenantName

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

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

-WhatIf

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

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

入力

None

出力

IResultObject