Import-CMAADServerApplication

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

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/2021datetime 変数が作成されます。 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.

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

-AppName

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

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

-AzureEnvironmentOption

このアプリの登録がグローバル Azure クラウド ()、または Azure Government クラウド (AzurePublicCloudAzureUSGovernmentCloud) 内にあるかどうかを指定します。

Type:AzureEnvironment
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientId

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

Type:String
Position:3
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

-SecretKey

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

Type:SecureString
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecretKeyExpiry

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

Type:DateTime
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

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

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

-TenantName

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

Type:String
Position:0
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