Update-AzADApplication

リファレンス

モジュール:: Az.Resources

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

構文

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>]

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>]

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 セクションを参照し、ハッシュテーブルを作成します。

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

-Api

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

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

-ApplicationId

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

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

-ApplicationTemplateId

applicationTemplate の一意識別子。

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

-AppRole

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

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

-AvailableToOtherTenants

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

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

-Confirm

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

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

-CreatedOnBehalfOfDeletedDateTime

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

-DefaultProfile

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

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

-DeletedDateTime

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

-Description

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

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

-DisabledByMicrosoftStatus

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

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

-DisplayName

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

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

-GroupMembershipClaim

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

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

-HomePage

Web のホームページ URL

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

-HomeRealmDiscoveryPolicy

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

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

-IdentifierUri

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

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

-Info

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

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

-InputObject

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

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

-IsDeviceOnlyAuthSupported

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

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

-IsFallbackPublicClient

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

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

-LogoInputFile

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

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

-Note

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

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

-Oauth2RequirePostResponse

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

-ObjectId

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

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

-OptionalClaim

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

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

-ParentalControlSetting

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

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

-PassThru

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

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

-PublicClientRedirectUri

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

-ReplyUrl

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

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

-RequestedAccessTokenVersion

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

-RequiredResourceAccess

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

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

-ServiceManagementReference

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

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

-SignInAudience

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

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

-SPARedirectUri

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

-Tag

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

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

-TokenEncryptionKeyId

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

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

-TokenIssuancePolicy

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

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

-TokenLifetimePolicy

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

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

-Web

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

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

-WhatIf

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

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

入力

IMicrosoftGraphApplication

出力

Boolean

メモ

エイリアス

Set-AzADApplication

次の方法で共有