Sdílet prostřednictvím


Set-AzureADMSApplication

Aktualizuje vlastnosti objektu aplikace.

Syntax

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>]
   [-OrgRestrictions <System.Collections.Generic.List`1[System.String]>]
   [-ParentalControlSettings <ParentalControlSettings>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]>]
   [-PreAuthorizedApplications <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PreAuthorizedApplication]>]
   [-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

Aktualizuje vlastnosti objektu aplikace.

Příklady

Příklad 1: Aktualizace aplikace

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" `
          -OrgRestrictions {orgrestrictions} `
          -PasswordCredentials {passwordcredentials} `
          -PreAuthorizedApplications {preauthorizedapplications} `
          -IdentifierUris "https://mynewapp.contoso.com"

Tento příkaz aktualizuje zadanou aplikaci.

Parametry

-AddIns

Definuje vlastní chování, které může spotřebovácí služba použít k volání aplikace v konkrétních kontextech. Například aplikace, které mohou vykreslovat datové proudy souborů mohou nastavit addIns vlastnost pro jeho "FileHandler" funkce. To umožní službám, jako je Office 365, volat aplikaci v kontextu dokumentu, na který uživatel pracuje.

Typ:List<T>[Microsoft.Open.MSGraph.Model.AddIn]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Api

Určuje nastavení pro aplikaci, která implementuje webové rozhraní API.

Typ:ApiApplication
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-AppRoles

Kolekce aplikačních rolí, které aplikace může deklarovat. Tyto role je možné přiřadit uživatelům, skupinám nebo instančním objektům.

Typ:List<T>[Microsoft.Open.MSGraph.Model.AppRole]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Určuje zobrazovaný název.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-GroupMembershipClaims

Nakonfiguruje deklaraci identity skupin vystavenou uživatelem nebo přístupovým tokenem OAuth 2.0, který aplikace očekává.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentifierUris

Určuje identifikátory URI.

Typ:List<T>[String]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationalUrl

Základní informace o profilu aplikace, jako jsou adresy URL pro marketing, podporu, podmínky služby a prohlášení o zásadách ochrany osobních údajů. Podmínky služby a prohlášení o zásadách ochrany osobních údajů se uživatelům zobrazují prostřednictvím prostředí pro vyjádření souhlasu uživatele.

Typ:InformationalUrl
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-IsDeviceOnlyAuthSupported

Určuje, jestli aplikace podporuje ověřování pomocí tokenu zařízení.

Typ:Boolean
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-IsFallbackPublicClient

Určuje typ náhradní aplikace jako veřejný klient, například nainstalovanou aplikaci spuštěnou na mobilním zařízení. Výchozí hodnota je false, což znamená, že typ záložní aplikace je důvěrný klient, například webová aplikace. Existují určité scénáře, kdy Azure AD nemůže určit typ klientské aplikace (např. tok ROPC tam, kde je nakonfigurovaný bez zadání identifikátoru URI přesměrování). V těchto případech azure AD interpretuje typ aplikace na základě hodnoty této vlastnosti.

Typ:Boolean
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyCredentials

Určuje přihlašovací údaje klíče.

Typ:List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Určuje ID aplikace v Azure AD.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-OptionalClaims

Vývojáři aplikací můžou ve svých aplikacích Azure AD nakonfigurovat volitelné deklarace identity a určit, které deklarace identity chtějí v tokenech odesílaných do své aplikace službou tokenů zabezpečení Microsoftu.

Typ:OptionalClaims
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-OrgRestrictions

Vyhrazeno pro budoucí použití.

Typ:List<T>[String]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-ParentalControlSettings

Určuje nastavení rodičovské kontroly pro aplikaci.

Typ:ParentalControlSettings
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordCredentials

Určuje přihlašovací údaje hesla.

Typ:List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-PreAuthorizedApplications

Zobrazí seznam aplikací a požadovaných oprávnění pro implicitní souhlas. Vyžaduje, aby správce poskytl souhlas s aplikací. preAuthorizedApplications nevyžadují, aby uživatel s požadovanými oprávněními souhlasil. Oprávnění uvedená v preAuthorizedApplications nevyžadují souhlas uživatele. Všechna další požadovaná oprávnění, která nejsou uvedená v preAuthorizedApplications, ale vyžadují souhlas uživatele.

Typ:List<T>[Microsoft.Open.MSGraph.Model.PreAuthorizedApplication]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicClient

Určuje, jestli je tato aplikace veřejným klientem (například nainstalovanou aplikací spuštěnou na mobilním zařízení). Výchozí hodnota je false.

Určuje, jestli je tato aplikace veřejným klientem (například nainstalovanou aplikací spuštěnou na mobilním zařízení). Výchozí hodnota je false.

Typ:PublicClientApplication
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredResourceAccess

@{Text=}

Typ:List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-SignInAudience

Určuje, jaké účty Microsoft jsou podporované pro aktuální aplikaci.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

Vlastní řetězce, které lze použít ke kategorizaci a identifikaci aplikace.

Typ:List<T>[String]
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-TokenEncryptionKeyId

Určuje id klíče veřejného klíče z kolekce keyCredentials. Při konfiguraci Azure AD šifruje všechny tokeny, které vygeneruje, pomocí klíče, na který tato vlastnost odkazuje. Kód aplikace, který přijímá šifrovaný token, musí k dešifrování tokenu použít odpovídající privátní klíč, aby ho bylo možné použít pro přihlášeného uživatele.

Typ:String
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-Web

Určuje nastavení webové aplikace.

Typ:WebApplication
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

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

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

List<T>[String]

Nullable<T>[Boolean]