Set-AzureADMSApplication

Referência

Módulo:: AzureADPreview

Atualiza as propriedades de um objeto de aplicação.

Sintaxe

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

Atualiza as propriedades de um objeto de aplicação.

Exemplos

Exemplo 1: Atualizar uma aplicação

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"

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 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.MSGraph.Model.AddIn]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Api

Especifica as definições de uma aplicação que implementa uma API Web.

Tipo:	ApiApplication
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.MSGraph.Model.AppRole]
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

-GroupMembershipClaims

Configura a afirmação de grupos emitida num token de acesso do OAuth 2.0 ou utilizador que a aplicação espera.

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

-IdentifierUris

Especifica URIs do identificador.

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

-InformationalUrl

Informações básicas do perfil da aplicação, como os URLs de marketing, suporte, termos de serviço e declaração de privacidade da aplicação. Os termos de serviço e declaração de privacidade são apresentados aos utilizadores através da experiência de consentimento do utilizador.

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

-IsDeviceOnlyAuthSupported

Especifica se a aplicação suporta a autenticação com um token de dispositivo.

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

-IsFallbackPublicClient

Especifica o tipo de aplicação de contingência como cliente público, como uma aplicação instalada em execução num dispositivo móvel. O valor predefinido é falso, o que significa que o tipo de aplicação de contingência é um cliente confidencial, como a aplicação Web. Existem determinados cenários em que o Azure AD não consegue determinar o tipo de aplicação cliente (por exemplo, fluxo ROPC onde está configurado sem especificar um URI de redirecionamento). Nesses casos, o Azure AD interpretará o tipo de aplicação com base no valor desta propriedade.

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

-KeyCredentials

Especifica as credenciais principais.

Tipo:	List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]
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

Os programadores de aplicações podem configurar afirmações opcionais nas respetivas aplicações do Azure AD para especificar as afirmações que pretendem em tokens enviados para a respetiva aplicação pelo serviço de tokens de segurança da Microsoft.

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

-OrgRestrictions

Reservado para utilização futura.

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

-ParentalControlSettings

Especifica as definições de controlo parental para uma aplicação.

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.MSGraph.Model.PasswordCredential]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PreAuthorizedApplications

Lista aplicações e permissões pedidas para consentimento implícito. Requer que um administrador tenha dado consentimento à aplicação. As aplicações preAuthorized Não requerem que o utilizador consenta as permissões pedidas. As permissões listadas em preAuthorizedApplications não requerem o consentimento do utilizador. No entanto, quaisquer permissões adicionais pedidas não listadas em aplicações pré-autenticadas requerem o consentimento do utilizador.

Tipo:	List<T>[Microsoft.Open.MSGraph.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:	PublicClientApplication
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RequiredResourceAccess

@{Text=}

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

-SignInAudience

Especifica as contas Microsoft suportadas para a aplicação atual.

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

-Tags

Cadeias personalizadas que podem ser utilizadas para categorizar e identificar a aplicação.

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

-TokenEncryptionKeyId

Especifica o keyId de uma chave pública da coleção keyCredentials. Quando configurado, o Azure AD encripta todos os tokens que emite com a chave a que esta propriedade aponta. O código da aplicação que recebe o token encriptado tem de utilizar a chave privada correspondente para desencriptar o token antes de poder ser utilizado para o utilizador com sessão iniciada.

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

-Web

Especifica as definições de uma aplicação Web.

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

Entradas

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]

Partilhar via