Sdílet prostřednictvím


Update-AzADApplication

Aktualizace entity v aplikacích

Syntaxe

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

Aktualizace entity v aplikacích

Příklady

Příklad 1: Aktualizace aplikace podle zobrazovaného názvu

Update-AzADApplication -DisplayName $name -HomePage $homepage

Aktualizace aplikace podle zobrazovaného názvu

Příklad 2: Aktualizace aplikace podle vstupu kanálu

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

Aktualizace aplikace podle vstupu kanálu

Parametry

-AddIn

Definuje vlastní chování, které může spotřebová služba použít k volání aplikace v konkrétních kontextech. Například aplikace, které mohou vykreslit streamy souborů, mohou nastavit vlastnost addIns pro jeho funkce FileHandler. To umožní službám, jako je Office 365, volat aplikaci v kontextu dokumentu, na který uživatel pracuje. Pokud chcete vytvořit, přečtěte si část POZNÁMKY o vlastnostech DOPLŇKU a vytvořte tabulku hash.

Typ:IMicrosoftGraphAddIn[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Api

ApiApplication To construct, see NOTES section for API properties and create a hash table.

Typ:IMicrosoftGraphApiApplication
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationId

klíč: ID aplikace

Typ:Guid
Aliasy:AppId
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTemplateId

Jedinečný identifikátor applicationTemplate.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AppRole

Kolekce rolí přiřazených k aplikaci. Při přiřazení rolí aplikace je možné tyto role přiřadit uživatelům, skupinám nebo instančním objektům přidruženým k jiným aplikacím. Nelze použít hodnotu null. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti APPROLE a vytvořte tabulku hash.

Typ:IMicrosoftGraphAppRole[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AvailableToOtherTenants

Hodnota určující, jestli je aplikace jedním tenantem nebo více tenanty. Je ekvivalentem hodnoty -SignInAudience AzureADMultipleOrgs, když je přepínač zapnutý.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CreatedOnBehalfOfDeletedDateTime

.

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:PSObject
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DeletedDateTime

.

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Volitelný popis aplikace. Vrátí se ve výchozím nastavení. Podporuje $filter (eq, ne, NOT, ge, le, startsWith) a $search.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisabledByMicrosoftStatus

Určuje, jestli společnost Microsoft zakázala registrovanou aplikaci. Možné hodnoty jsou: null (výchozí hodnota), NotDisabled a DisabledDueToViolationOfServicesAgreement (důvody můžou zahrnovat podezřelé, zneužívající nebo škodlivé aktivity nebo porušení smlouvy o poskytování služeb společnosti Microsoft). Podporuje $filter (eq, ne, NOT).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayName

Zobrazovaný název aplikace. Podporuje $filter (eq, ne, NOT, ge, le, in, startsWith), $search a $orderBy.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GroupMembershipClaim

Nakonfiguruje deklaraci identity skupin vystavenou v přístupovém tokenu uživatele nebo OAuth 2.0, který aplikace očekává. Chcete-li nastavit tento atribut, použijte jednu z následujících řetězcových hodnot: None, SecurityGroup (pro skupiny zabezpečení a role Azure AD), All (to získá všechny skupiny zabezpečení, distribuční skupiny a role adresáře Azure AD, které je přihlášený uživatel členem).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HomePage

Adresa URL domovské stránky pro web

Typ:String
Aliasy:WebHomePageUrl
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HomeRealmDiscoveryPolicy

. Chcete-li vytvořit, viz poznámky oddílu HOMEREALMDISCOVERYPOLICY vlastnosti a vytvoření hash tabulky.

Typ:IMicrosoftGraphHomeRealmDiscoveryPolicy[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IdentifierUri

Identifikátory URI, které identifikují aplikaci v rámci tenanta Azure AD nebo v rámci ověřené vlastní domény, pokud je aplikace víceklientské. Další informace naleznete v tématu Objekty aplikace a instanční objekty. Libovolný operátor je vyžadován pro výrazy filtru u vlastností s více hodnotami. Nelze použít hodnotu null. Podporuje $filter (eq, ne, ge, le, startsWith).

Typ:String[]
Aliasy:IdentifierUris
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Info

informationalUrl To construct, see NOTES section for INFO properties and create a hash table.

Typ:IMicrosoftGraphInformationalUrl
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

key: objekt aplikace

Typ:IMicrosoftGraphApplication
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-IsDeviceOnlyAuthSupported

Určuje, jestli tato aplikace podporuje ověřování zařízení bez uživatele. Výchozí hodnota je false.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IsFallbackPublicClient

Určuje záložní typ 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 záložní typ aplikace je důvěrný klient, jako je webová aplikace. Existují určité scénáře, kdy Azure AD nemůže určit typ klientské aplikace. Například tok ROPC, ve kterém je aplikace nakonfigurovaná bez zadání identifikátoru URI přesměrování. V takových případech Azure AD interpretuje typ aplikace na základě hodnoty této vlastnosti.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LogoInputFile

Vstupní soubor pro logo (hlavní logo aplikace. Nelze použít hodnotu null.)

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Note

Poznámky týkající se správy aplikace.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Oauth2RequirePostResponse

.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ObjectId

key: ID aplikace

Typ:String
Aliasy:Id
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OptionalClaim

optionalClaims To construct, see NOTES section for OPTIONALCLAIM properties and create a hash table.

Typ:IMicrosoftGraphOptionalClaims
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ParentalControlSetting

parentalControlSettings To construct, see NOTES section for PARENTALCONTROLSETTING properties and create a hash table.

Typ:IMicrosoftGraphParentalControlSettings
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Vrátí hodnotu true, když příkaz proběhne úspěšně.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PublicClientRedirectUri

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ReplyUrl

Adresy URL odpovědí aplikace.

Typ:String[]
Aliasy:ReplyUrls, WebRedirectUri
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RequestedAccessTokenVersion

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RequiredResourceAccess

Určuje prostředky, ke kterým má aplikace přístup. Tato vlastnost také určuje sadu oborů oprávnění OAuth a aplikačních rolí, které potřebuje pro každý z těchto prostředků. Tato konfigurace přístupu k požadovaným prostředkům řídí prostředí souhlasu. Nelze použít hodnotu null. Podporuje $filter (eq, NOT, ge, le). Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti REQUIREDRESOURCEACCESS a vytvořte tabulku hash.

Typ:IMicrosoftGraphRequiredResourceAccess[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServiceManagementReference

Odkazuje na kontaktní informace aplikace nebo služby z databáze služby nebo správy prostředků. Nullable.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SignInAudience

Určuje účty Microsoft, které jsou podporovány pro aktuální aplikaci. Podporované hodnoty jsou: AzureADMyOrg, AzureADMultipleOrgs, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount. Další informace najdete v následující tabulce. Podporuje $filter (eq, ne, NOT).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SPARedirectUri

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Vlastní řetězce, které lze použít k kategorizaci a identifikaci aplikace. Nelze použít hodnotu null. Podporuje $filter (eq, NOT, ge, le, startsWith).

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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é generuje, 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
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TokenIssuancePolicy

. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti TOKENISSUANCEPOLICY a vytvořte tabulku hash.

Typ:IMicrosoftGraphTokenIssuancePolicy[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TokenLifetimePolicy

TokenLifetimePolicies přiřazené k této aplikaci. Podporuje $expand. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti TOKENLIFETIMEPOLICY a vytvořte tabulku hash.

Typ:IMicrosoftGraphTokenLifetimePolicy[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Web

webApplication To construct, see NOTES section for WEB properties and create a hash table.

Typ:IMicrosoftGraphWebApplication
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

IMicrosoftGraphApplication

Výstupy

Boolean

Poznámky

ALIASY

Set-AzADApplication