Set-AzureADMSApplication

參考

模組:: AzureAD

更新應用程式物件的屬性。

語法

Set-AzureADMSApplication
   -ObjectId <String>
   [-AddIns <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AddIn]>]
   [-Api <ApiApplication>]
   [-AppRoles <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole]>]
   [-GroupMembershipClaims <String>]
   [-IsDeviceOnlyAuthSupported <Boolean>]
   [-IsFallbackPublicClient <Boolean>]
   [-IdentifierUris <System.Collections.Generic.List`1[System.String]>]
   [-DisplayName <String>]
   [-InformationalUrl <InformationalUrl>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential]>]
   [-OptionalClaims <OptionalClaims>]
   [-ParentalControlSettings <ParentalControlSettings>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]>]
   [-PublicClient <PublicClientApplication>]
   [-RequiredResourceAccess <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]>]
   [-SignInAudience <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [-TokenEncryptionKeyId <String>]
   [-Web <WebApplication>]
   [<CommonParameters>]

Description

更新應用程式物件的屬性。

範例

範例 1：更新應用程式

PS C:\>Set-AzureADMSApplication -ObjectId fcd37fb8-449c-45af-92fc-5448c671fd30 `
          -DisplayName "my name" `
          -AddIns @{ Type = "mytype"; Properties = [PSCustomObject]@{ Key = "key"; Value = "value" } } `
          -Api @{ AcceptMappedClaims = $true } `
          -AppRoles @{ Id = "21111111-1111-1111-1111-111111111111"; DisplayName = "role"; AllowedMemberTypes = "User"; Description = "mydescription"; Value = "myvalue" } `
          -InformationalUrl @{ SupportUrl = "https://mynewapp.contoso.com/support.html" } `
          -IsDeviceOnlyAuthSupported $false `
          -IsFallbackPublicClient $false `
          -KeyCredentials @{ KeyId = "41111111-1111-1111-1111-111111111111"; Usage = "Encrypt"; Key = [System.IO.File]::ReadAllBytes("file.cer"); Type = "AsymmetricX509Cert" } `
          -OptionalClaims @{ IdToken = [PSCustomObject]@{ Name = "claimName"; Source = "claimSource" } } `
          -ParentalControlSettings @{ LegalAgeGroupRule = "Block" } `
          -PublicClient @{ RedirectUris = "https://mynewapp.contoso.com/" } `
          -RequiredResourceAccess @{ ResourceAppId = "31111111-1111-1111-1111-111111111111"; ResourceAccess = [PSCustomObject]@{ Type = "Scope" } } `
          -SignInAudience AzureADandPersonalMicrosoftAccount `
          -Tags "mytag" `
          -TokenEncryptionKeyId "41111111-1111-1111-1111-111111111111" `
          -Web @{ LogoutUrl = "https://mynewapp.contoso.com/logout.html" } `
          -GroupMembershipClaims "SecurityGroup" `
          -IdentifierUris "https://mynewapp.contoso.com"`
          -PasswordCredentials {passwordcredentials}

此命令會更新指定的應用程式。

參數

-AddIns

定義取用服務可用來在特定內容中呼叫應用程式的自訂行為。例如，可以轉譯檔案資料流的應用程式可能會為其 "FileHandler" 功能設定 addIns 屬性。這可讓如 Office 365 等服務在使用者目前正在處理的文件內容中呼叫應用程式。

類型:	List<T>[Microsoft.Open.MSGraph.Model.AddIn]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Api

指定實作 Web API 的應用程式設定。

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

-AppRoles

應用程式可以宣告的應用程式角色的集合。這些角色可以指派給使用者、群組或服務主體。

類型:	List<T>[Microsoft.Open.MSGraph.Model.AppRole]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisplayName

指定顯示名稱。

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

-GroupMembershipClaims

設定應用程式預期在使用者或 OAuth 2.0 存取令牌中發出的群組宣告。

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

-IdentifierUris

指定標識碼 URI。

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

-InformationalUrl

應用程式的基本配置檔資訊，例如應用程式的行銷、支援、服務條款和隱私聲明 URL。使用者會透過使用者同意體驗看到服務條款和隱私權聲明。

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

-IsDeviceOnlyAuthSupported

指定應用程式是否支援使用裝置令牌進行驗證。

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

-IsFallbackPublicClient

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

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

-KeyCredentials

指定金鑰認證。

類型:	List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ObjectId

指定 Azure AD 中應用程式的識別碼。

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

-OptionalClaims

應用程式開發人員可以在其 Azure AD 應用程式中設定選擇性宣告，以指定他們在 Microsoft 安全性令牌服務傳送至其應用程式的令牌中想要的宣告。

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

-ParentalControlSettings

指定應用程式的家長控制設定。

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

-PasswordCredentials

與應用程式相關聯的密碼認證集合

類型:	List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PublicClient

指定此應用程式是否為公開用戶端 (例如行動裝置上執行的已安裝應用程式)。預設值為 false。

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

-RequiredResourceAccess

@{Text=}

類型:	List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SignInAudience

指定目前的應用程式支援哪些 Microsoft 帳戶。

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

-Tags

可用來分類及識別應用程式的自訂字串。

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

-TokenEncryptionKeyId

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

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

-Web

指定 Web 應用程式的設定。

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

輸入

Boolean

Microsoft.Open.MSGraph.Model.ApiApplication

Microsoft.Open.MSGraph.Model.InformationalUrl

Microsoft.Open.MSGraph.Model.OptionalClaims

Microsoft.Open.MSGraph.Model.ParentalControlSettings

Microsoft.Open.MSGraph.Model.PublicClientApplication

Microsoft.Open.MSGraph.Model.WebApplication

string

List<T>[Microsoft.Open.MSGraph.Model.AddIn]

List<T>[Microsoft.Open.MSGraph.Model.AppRole]

List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]

List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]

List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]

List<T>[String]

Nullable<T>[Boolean]

共用方式為