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

Description

更新應用程式中的實體

範例

範例 1：依顯示名稱更新應用程式

Update-AzADApplication -DisplayName $name -HomePage $homepage

依顯示名稱更新應用程式

範例 2：依管線輸入更新應用程式

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

依管線輸入更新應用程式

參數

-AddIn

定義取用服務可用來在特定內容中呼叫應用程式的自定義行為。例如，可以轉譯檔案數據流的應用程式可能會為其『FileHandler』功能設定 addIns 屬性。這可讓 Office 365 等服務在使用者正在處理的文件內容中呼叫應用程式。若要建構，請參閱 ADDIN 屬性的 NOTES 區段並建立哈希表。

類型:	IMicrosoftGraphAddIn[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Api

apiApplication 若要建構，請參閱 API 屬性和建立哈希表的 NOTES 一節。

類型:	IMicrosoftGraphApiApplication
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ApplicationId

機碼：應用程式識別碼

類型:	Guid
別名:	AppId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ApplicationTemplateId

applicationTemplate 的唯一標識符。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppRole

指派給應用程式的角色集合。透過應用程式角色指派，這些角色可以指派給與其他應用程式相關聯的使用者、群組或服務主體。不可為 Null。若要建構，請參閱APPROLE屬性的NOTES一節，並建立哈希表。

類型:	IMicrosoftGraphAppRole[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AvailableToOtherTenants

值，指定應用程式是單一租用戶還是多租使用者。切換開啟時，相當於 '-SignInAudience AzureADMultipleOrgs'

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CreatedOnBehalfOfDeletedDateTime

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	PSObject
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeletedDateTime

類型:	DateTime
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

應用程式的選擇性描述。預設會傳回。支援$filter（eq、ne、NOT、ge、le、startsWith）和$search。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisabledByMicrosoftStatus

指定Microsoft是否已停用已註冊的應用程式。可能的值為：null（預設值）、NotDisabled 和 DisabledDueToViolationOfServicesAgreement（原因可能包括可疑、濫用或惡意活動，或違反Microsoft服務合約）。支援$filter（eq、ne、NOT）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisplayName

應用程式的顯示名稱。支援$filter（eq、ne、NOT、ge、le、in、startsWith）、$search和$orderBy。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GroupMembershipClaim

設定應用程式預期的使用者或 OAuth 2.0 存取令牌中發出的群組宣告。若要設定此屬性，請使用下列其中一個字串值：None、SecurityGroup（適用於安全組和 Azure AD 角色）、All（這會取得登入使用者所屬的所有安全組、通訊群組和 Azure AD 目錄角色）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HomePage

網頁的首頁 URL

類型:	String
別名:	WebHomePageUrl
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HomeRealmDiscoveryPolicy

. 若要建構，請參閱 HOMEREALMDISCOVERYPOLICY 屬性的 NOTES 區段，並建立哈希表。

類型:	IMicrosoftGraphHomeRealmDiscoveryPolicy[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdentifierUri

識別其 Azure AD 租使用者內應用程式，或在已驗證的自定義網域中，如果應用程式是多租使用者，則為 URI。如需詳細資訊，請參閱 Application Objects 和服務主體物件。在多重值屬性上篩選表達式需要任何運算元。不可為 Null。支援$filter（eq、ne、ge、le、startsWith）。

類型:	String[]
別名:	IdentifierUris
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Info

informationalUrl 若要建構，請參閱 INFO 屬性和建立哈希表的 NOTES 一節。

類型:	IMicrosoftGraphInformationalUrl
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

機碼：應用程式物件

類型:	IMicrosoftGraphApplication
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-IsDeviceOnlyAuthSupported

指定此應用程式是否支援沒有使用者的裝置驗證。默認值為 false。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IsFallbackPublicClient

指定後援應用程式類型做為公用用戶端，例如在行動裝置上執行的已安裝應用程式。默認值為 false，表示後援應用程式類型是機密用戶端，例如 Web 應用程式。在某些情況下，Azure AD 無法判斷用戶端應用程式類型。例如，未指定重新導向 URI 的情況下設定應用程式的 ROPC 流程。在這些情況下，Azure AD 會根據此屬性的值來解譯應用程序類型。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LogoInputFile

標誌的輸入檔（應用程式的主要標誌。不可為 Null。）

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Note

與應用程式管理相關的注意事項。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Oauth2RequirePostResponse

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ObjectId

機碼：應用程式的標識碼

類型:	String
別名:	Id
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-OptionalClaim

optionalClaims 若要建構，請參閱 OPTIONALCLAIM 屬性和建立哈希表的 NOTES 一節。

類型:	IMicrosoftGraphOptionalClaims
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ParentalControlSetting

parentalControlSettings 若要建構，請參閱 PARENTALCONTROLSETTING 屬性的 NOTES 一節，並建立哈希表。

類型:	IMicrosoftGraphParentalControlSettings
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

當命令成功時傳回 true

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublicClientRedirectUri

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReplyUrl

應用程式回復URL。

類型:	String[]
別名:	ReplyUrls, WebRedirectUri
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RequestedAccessTokenVersion

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RequiredResourceAccess

指定應用程式需要存取的資源。這個屬性也會指定每個資源所需的 OAuth 許可權範圍和應用程式角色集合。此必要資源的存取設定會驅動同意體驗。不可為 Null。支援$filter（eq、NOT、ge、le）。若要建構，請參閱 REQUIREDRESOURCEACCESS 屬性的 NOTES 區段並建立哈希表。

類型:	IMicrosoftGraphRequiredResourceAccess[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServiceManagementReference

參考來自服務或資產管理資料庫的應用程式或服務連絡資訊。空。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SignInAudience

指定目前應用程式支援的Microsoft帳戶。支援的值為：AzureADMyOrg、AzureADMultipleOrgs、AzureADandPersonalMicrosoftAccount、PersonalMicrosoftAccount。如需詳細資訊，請參閱下表。支援$filter（eq、ne、NOT）。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SPARedirectUri

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

可用來分類和識別應用程式的自定義字串。不可為 Null。支援$filter（eq、NOT、ge、le、startsWith）。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TokenEncryptionKeyId

從keyCredentials集合指定公鑰的keyId。設定時，Azure AD 會使用此屬性所指向的金鑰來加密它發出的所有令牌。接收加密令牌的應用程式程式代碼必須使用相符的私鑰來解密令牌，才能用於登入的使用者。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TokenIssuancePolicy

. 若要建構，請參閱 TOKENISSUANCEPOLICY 屬性的 NOTES 區段並建立哈希表。

類型:	IMicrosoftGraphTokenIssuancePolicy[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TokenLifetimePolicy

指派給此應用程式的 tokenLifetimePolicies。支援$expand。若要建構，請參閱 TOKENLIFETIMEPOLICY 屬性的 NOTES 區段並建立哈希表。

類型:	IMicrosoftGraphTokenLifetimePolicy[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Web

webApplication 若要建構，請參閱 WEB 屬性的 NOTES 一節，並建立哈希表。

類型:	IMicrosoftGraphWebApplication
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

IMicrosoftGraphApplication

輸出

Boolean

備註

別名

Set-AzADApplication

共用方式為