Update-AzADApplication

構文

ApplicationObjectIdWithUpdateParamsParameterSet (既定)

Update-AzADApplication
    -ObjectId <String>
    [-HomePage <String>]
    [-ReplyUrl <String[]>]
    [-AvailableToOtherTenants <Boolean>]
    [-AddIn <IMicrosoftGraphAddIn[]>]
    [-Api <IMicrosoftGraphApiApplication>]
    [-AppRole <IMicrosoftGraphAppRole[]>]
    [-ApplicationTemplateId <String>]
    [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-DisabledByMicrosoftStatus <String>]
    [-DisplayName <String>]
    [-GroupMembershipClaim <String>]
    [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
    [-IdentifierUri <String[]>]
    [-Info <IMicrosoftGraphInformationalUrl>]
    [-IsDeviceOnlyAuthSupported]
    [-IsFallbackPublicClient]
    [-LogoInputFile <String>]
    [-Note <String>]
    [-Oauth2RequirePostResponse]
    [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
    [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
    [-PublicClientRedirectUri <String[]>]
    [-RequestedAccessTokenVersion <Int32>]
    [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
    [-ServiceManagementReference <String>]
    [-SignInAudience <String>]
    [-SPARedirectUri <String[]>]
    [-Tag <String[]>]
    [-TokenEncryptionKeyId <String>]
    [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
    [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
    [-Web <IMicrosoftGraphWebApplication>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationIdWithUpdateParamsParameterSet

Update-AzADApplication
    -ApplicationId <Guid>
    [-HomePage <String>]
    [-ReplyUrl <String[]>]
    [-AvailableToOtherTenants <Boolean>]
    [-AddIn <IMicrosoftGraphAddIn[]>]
    [-Api <IMicrosoftGraphApiApplication>]
    [-AppRole <IMicrosoftGraphAppRole[]>]
    [-ApplicationTemplateId <String>]
    [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-DisabledByMicrosoftStatus <String>]
    [-DisplayName <String>]
    [-GroupMembershipClaim <String>]
    [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
    [-IdentifierUri <String[]>]
    [-Info <IMicrosoftGraphInformationalUrl>]
    [-IsDeviceOnlyAuthSupported]
    [-IsFallbackPublicClient]
    [-LogoInputFile <String>]
    [-Note <String>]
    [-Oauth2RequirePostResponse]
    [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
    [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
    [-PublicClientRedirectUri <String[]>]
    [-RequestedAccessTokenVersion <Int32>]
    [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
    [-ServiceManagementReference <String>]
    [-SignInAudience <String>]
    [-SPARedirectUri <String[]>]
    [-Tag <String[]>]
    [-TokenEncryptionKeyId <String>]
    [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
    [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
    [-Web <IMicrosoftGraphWebApplication>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectWithUpdateParamsParameterSet

Update-AzADApplication
    -InputObject <IMicrosoftGraphApplication>
    [-HomePage <String>]
    [-ReplyUrl <String[]>]
    [-AvailableToOtherTenants <Boolean>]
    [-AddIn <IMicrosoftGraphAddIn[]>]
    [-Api <IMicrosoftGraphApiApplication>]
    [-AppRole <IMicrosoftGraphAppRole[]>]
    [-ApplicationTemplateId <String>]
    [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-DisabledByMicrosoftStatus <String>]
    [-DisplayName <String>]
    [-GroupMembershipClaim <String>]
    [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
    [-IdentifierUri <String[]>]
    [-Info <IMicrosoftGraphInformationalUrl>]
    [-IsDeviceOnlyAuthSupported]
    [-IsFallbackPublicClient]
    [-LogoInputFile <String>]
    [-Note <String>]
    [-Oauth2RequirePostResponse]
    [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
    [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
    [-PublicClientRedirectUri <String[]>]
    [-RequestedAccessTokenVersion <Int32>]
    [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
    [-ServiceManagementReference <String>]
    [-SignInAudience <String>]
    [-SPARedirectUri <String[]>]
    [-Tag <String[]>]
    [-TokenEncryptionKeyId <String>]
    [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
    [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
    [-Web <IMicrosoftGraphWebApplication>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

例

例 1: 表示名でアプリケーションを更新する

Update-AzADApplication -DisplayName $name -HomePage $homepage

例 2: パイプライン入力によるアプリケーションの更新

Get-AzADApplication -ObjectId $id | Update-AzADApplication -ReplyUrl $replyurl

パラメーター

-AddIn

特定のコンテキストで利用者サービスがアプリを呼び出すために使用できるカスタムの動作を定義します。 たとえば、ファイル ストリームをレンダリングできるアプリケーションでは、'FileHandler' 機能の addIns プロパティを設定できます。 これにより、Office 365 などのサービスは、ユーザーが作業しているドキュメントのコンテキストでアプリケーションを呼び出すようになります。 構築するには、ADDIN プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-Api

apiApplication 構築するには、API プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-ApplicationId

キー: アプリケーション ID

パラメーターのプロパティ

パラメーター セット

-ApplicationTemplateId

applicationTemplate の一意識別子。

パラメーターのプロパティ

パラメーター セット

-AppRole

アプリケーションに割り当てられたロールのコレクション。 アプリ ロールの割り当てでは、これらのロールを他のアプリケーションに関連付けられているユーザー、グループ、またはサービス プリンシパルに割り当てることができます。 null 許容ではありません。 構築するには、APPROLE プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-AvailableToOtherTenants

アプリケーションがシングル テナントかマルチテナントかを指定する値。 スイッチがオンの場合の '-SignInAudience AzureADMultipleOrgs' に相当します

パラメーターのプロパティ

パラメーター セット

-Confirm

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

パラメーターのプロパティ

パラメーター セット

-CreatedOnBehalfOfDeletedDateTime

.

パラメーターのプロパティ

パラメーター セット

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

パラメーターのプロパティ

パラメーター セット

-DeletedDateTime

.

パラメーターのプロパティ

パラメーター セット

-Description

アプリケーションの省略可能な説明。 既定で返されます。 $filter (eq、ne、NOT、ge、le、startsWith) と$searchをサポートします。

パラメーターのプロパティ

パラメーター セット

-DisabledByMicrosoftStatus

Microsoft で登録済みアプリケーションを無効にしたかどうかを指定します。 使用可能な値は、null (既定値)、NotDisabled、DisabledDueToViolationOfServicesAgreement です (疑わしい、攻撃的、悪意のあるアクティビティ、または Microsoft サービス契約違反が含まれる可能性がある理由)。 $filter (eq、ne、NOT) をサポートします。

パラメーターのプロパティ

パラメーター セット

-DisplayName

アプリケーションの表示名。 $filter (eq、ne、NOT、ge、le、in、startsWith)、$search、$orderByをサポートします。

パラメーターのプロパティ

パラメーター セット

-GroupMembershipClaim

アプリケーションが想定するユーザーまたは OAuth 2.0 アクセス トークンで発行されたグループ要求を構成します。 この属性を設定するには、次のいずれかの文字列値を使用します。None、SecurityGroup (セキュリティ グループと Azure AD ロールの場合)、All (これにより、サインインしているユーザーがメンバーであるすべてのセキュリティ グループ、配布グループ、および Azure AD ディレクトリ ロールが取得されます)。

パラメーターのプロパティ

パラメーター セット

-HomePage

Web のホーム ページ URL

パラメーターのプロパティ

パラメーター セット

-HomeRealmDiscoveryPolicy

. 構築するには、HOMEREALMDISCOVERYPOLICY プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-IdentifierUri

Azure AD テナント内、またはアプリケーションがマルチテナントの場合は検証済みのカスタム ドメイン内で、アプリケーションを識別する URI。 詳細については、「アプリケーション オブジェクトとサービス プリンシパル オブジェクト」を参照してください。 複数値プロパティのフィルター式には、任意の演算子が必要です。 null 許容ではありません。 $filter (eq、ne、ge、le、startsWith) をサポートします。

パラメーターのプロパティ

パラメーター セット

-Info

informationalUrl 構築するには、INFO プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-InputObject

キー: アプリケーション オブジェクト

パラメーターのプロパティ

パラメーター セット

-IsDeviceOnlyAuthSupported

このアプリケーションがユーザーなしでデバイス認証をサポートするかどうかを指定します。 既定値は false です。

パラメーターのプロパティ

パラメーター セット

-IsFallbackPublicClient

モバイル デバイスで実行されているインストール済みアプリケーションなど、フォールバック アプリケーション タイプをパブリック クライアントとして指定します。 既定値は false です。これは、フォールバック アプリケーションの種類が Web アプリなどの機密クライアントであることを意味します。 Azure AD でクライアント アプリケーションの種類を特定できないシナリオがあります。 たとえば、リダイレクト URI を指定せずにアプリケーションが構成されている ROPC フローです。 このような場合、Azure AD は、このプロパティの値に基づいてアプリケーションの種類を解釈します。

パラメーターのプロパティ

パラメーター セット

-LogoInputFile

ロゴの入力ファイル (アプリケーションのメイン ロゴ。null 許容ではありません。)

パラメーターのプロパティ

パラメーター セット

-Note

アプリケーションの管理に関連する注意事項。

パラメーターのプロパティ

パラメーター セット

-Oauth2RequirePostResponse

.

パラメーターのプロパティ

パラメーター セット

-ObjectId

キー: アプリケーションの ID

パラメーターのプロパティ

パラメーター セット

-OptionalClaim

optionalClaims 構築するには、OPTIONALCLAIM プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-ParentalControlSetting

parentalControlSettings 構築するには、PARENTALCONTROLSETTING プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-PassThru

コマンドが成功したときに true を返します。

パラメーターのプロパティ

パラメーター セット

-PublicClientRedirectUri

アプリケーションのエンティティを更新する

パラメーターのプロパティ

パラメーター セット

-ReplyUrl

アプリケーションの応答 URL。

パラメーターのプロパティ

パラメーター セット

-RequestedAccessTokenVersion

アプリケーションのエンティティを更新する

パラメーターのプロパティ

パラメーター セット

-RequiredResourceAccess

アプリケーションがアクセスする必要があるリソースを指定します。 また、このプロパティは、これらのリソースごとに必要な OAuth アクセス許可スコープとアプリケーション ロールのセットも指定します。 必要なリソースへのアクセスに対するこの構成によって、同意エクスペリエンスが促進されます。 null 許容ではありません。 $filter (eq、NOT、ge、le) をサポートします。 構築するには、REQUIREDRESOURCEACCESS プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-ServiceManagementReference

サービスまたは資産管理データベースからアプリケーションまたはサービスの連絡先情報を参照します。 Nullable.

パラメーターのプロパティ

パラメーター セット

-SignInAudience

現在のアプリケーションでサポートされている Microsoft アカウントを指定します。 サポートされている値は、AzureADMyOrg、AzureADMultipleOrgs、AzureADandPersonalMicrosoftAccount、PersonalMicrosoftAccount です。 詳細については、次の表を参照してください。 $filter (eq、ne、NOT) をサポートします。

パラメーターのプロパティ

パラメーター セット

-SPARedirectUri

アプリケーションのエンティティを更新する

パラメーターのプロパティ

パラメーター セット

-Tag

アプリケーションの分類と特定に使用できるカスタム文字列。 null 許容ではありません。$filter (eq、NOT、ge、le、startsWith) をサポートします。

パラメーターのプロパティ

パラメーター セット

-TokenEncryptionKeyId

keyCredentials コレクションにある公開キーの keyId を指定します。 構成すると、Azure AD は、このプロパティが指すキーを使用して、出力されるすべてのトークンを暗号化します。 暗号化されたトークンを受け取るアプリケーション コードでは、一致する秘密キーを使用してトークンを複合化してから、サインインしているユーザーのトークンとして使用する必要があります。

パラメーターのプロパティ

パラメーター セット

-TokenIssuancePolicy

. 構築するには、TOKENISSUANCEPOLICY プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-TokenLifetimePolicy

このアプリケーションに割り当てられている tokenLifetimePolicy。 $expandをサポートします。 構築するには、TOKENLIFETIMEPOLICY プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-Web

webApplication 構築するには、WEB プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

パラメーターのプロパティ

パラメーター セット

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

IMicrosoftGraphApplication

出力

Boolean

メモ