Set-AzureADApplication

  • Referência
Módulo:
AzureAD

Atualiza uma aplicação.

Sintaxe

Set-AzureADApplication
   -ObjectId <String>
   [-AddIns <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AddIn]>]
   [-AllowGuestsSignIn <Boolean>]
   [-AllowPassthroughUsers <Boolean>]
   [-AppLogoUrl <String>]
   [-AppRoles <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AppRole]>]
   [-AvailableToOtherTenants <Boolean>]
   [-DisplayName <String>]
   [-ErrorUrl <String>]
   [-GroupMembershipClaims <String>]
   [-Homepage <String>]
   [-IdentifierUris <System.Collections.Generic.List`1[System.String]>]
   [-InformationalUrls <InformationalUrl>]
   [-IsDeviceOnlyAuthSupported <Boolean>]
   [-IsDisabled <Boolean>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
   [-KnownClientApplications <System.Collections.Generic.List`1[System.String]>]
   [-LogoutUrl <String>]
   [-Oauth2AllowImplicitFlow <Boolean>]
   [-Oauth2AllowUrlPathMatching <Boolean>]
   [-Oauth2Permissions <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.OAuth2Permission]>]
   [-Oauth2RequirePostResponse <Boolean>]
   [-OrgRestrictions <System.Collections.Generic.List`1[System.String]>]
   [-OptionalClaims <OptionalClaims>]
   [-ParentalControlSettings <ParentalControlSettings>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
   [-PreAuthorizedApplications <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PreAuthorizedApplication]>]
   [-PublicClient <Boolean>]
   [-PublisherDomain <String>]
   [-RecordConsentConditions <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-RequiredResourceAccess <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.RequiredResourceAccess]>]
   [-SamlMetadataUrl <String>]
   [-SignInAudience <String>]
   [-WwwHomepage <String>]
   [<CommonParameters>]

Exemplos

Exemplo 1: Atualizar uma aplicação

PS C:\>Set-AzureADApplication -ObjectId "3ddd22e7-a150-4bb3-b100-e410dea1cb84" -DisplayName "New Name"

Este comando atualiza a aplicação especificada.

Parâmetros

-AddIns

Define o comportamento personalizado que um serviço de consumo pode utilizar para chamar uma aplicação em contextos específicos. Por exemplo, as aplicações que podem compor fluxos de ficheiros podem definir a propriedade addIns para a respetiva funcionalidade "FileHandler". Isto permitirá que serviços como o Office 365 chamem a aplicação no contexto de um documento em que o utilizador está a trabalhar.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.AddIn]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AllowGuestsSignIn

{{ Fill AllowGuestsSignIn Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AllowPassthroughUsers

{{ Fill AllowPassthroughUsers Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppLogoUrl

{{ Fill AppLogoUrl Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppRoles

A coleção de funções de aplicação que uma aplicação pode declarar. Estas funções podem ser atribuídas a utilizadores, grupos ou principais de serviço.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.AppRole]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AvailableToOtherTenants

Verdadeiro se a aplicação for partilhada com outros inquilinos; caso contrário, falso.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

Especifica o nome a apresentar.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ErrorUrl

Especifica um URL de erro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-GroupMembershipClaims

Uma máscara de bits que configura a afirmação "grupos" emitida num token de acesso de utilizador ou OAuth 2.0 que a aplicação espera. Os valores da máscara de bits são: 0: Nenhum, 1: Grupos de segurança e funções do Azure AD, 2: Reservado e 4: Reservado. Definir a máscara de bits como 7 irá obter todos os grupos de segurança, grupos de distribuição e funções de diretório do Azure AD das quais o utilizador com sessão iniciada é membro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Homepage

Especifica a home page.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IdentifierUris

Especifica os URIs do identificador.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationalUrls

{{ Fill InformationalUrls Description }}

Tipo:InformationalUrl
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsDeviceOnlyAuthSupported

{{ Fill IsDeviceOnlyAuthSupported Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsDisabled

{{ Fill IsDisabled Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KeyCredentials

Especifica credenciais de chave.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KnownClientApplications

Especifica aplicações cliente conhecidas.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LogoutUrl

Especifica o URL de fim de sessão.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2AllowImplicitFlow

Especifica se esta aplicação Web pode pedir tokens de fluxo implícitos OAuth2.0. A predefinição é false.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2AllowUrlPathMatching

Especifica se, como parte dos pedidos de tokens OAuth 2.0, o Azure AD permitirá a correspondência de caminhos do URI de redirecionamento com os replyUrls da aplicação. A predefinição é false.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2Permissions

A coleção de âmbitos de permissão do OAuth 2.0 que a aplicação API Web (recurso) expõe às aplicações cliente. Estes âmbitos de permissão podem ser concedidos a aplicações cliente durante o consentimento.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.OAuth2Permission]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2RequirePostResponse

{{Fill Oauth2RequirePostResponse Description}}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ObjectId

Especifica o ID de uma aplicação no Azure AD.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OptionalClaims

{{ Fill OptionalClaims Description }}

Tipo:OptionalClaims
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OrgRestrictions

{{ Fill OrgRestrictions Description }}

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ParentalControlSettings

{{ Fill ParentalControlSettings Description }}

Tipo:ParentalControlSettings
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PasswordCredentials

Especifica credenciais de palavra-passe.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PreAuthorizedApplications

{{ Preenchimento Preenchimento PreenchimentoDescrição de Aplicações }}

Tipo:List<T>[Microsoft.Open.AzureAD.Model.PreAuthorizedApplication]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicClient

Especifica se esta aplicação é um cliente público (como uma aplicação instalada em execução num dispositivo móvel). A predefinição é falso.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublisherDomain

{{ Fill PublisherDomain Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RecordConsentConditions

Não utilizar. Pode ser removido em versões futuras

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ReplyUrls

Especifica os URLs para os quais os tokens de utilizador são enviados para iniciar sessão ou os URIs de redirecionamento para os quais os códigos de autorização E tokens de acesso do OAuth 2.0 são enviados.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RequiredResourceAccess

@{Text=}

Tipo:List<T>[Microsoft.Open.AzureAD.Model.RequiredResourceAccess]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SamlMetadataUrl

@{Text=}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SignInAudience

{{ Fill SignInAudience Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WwwHomepage

{{ Fill WwwHomepage Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Notas

Veja o guia de migração de Set-AzureADApplication para o PowerShell do Microsoft Graph.