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