Compartilhar via


Set-MsolServicePrincipal

Atualiza uma entidade de serviço no Microsoft Azure Active Directory.

Sintaxe

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Set-MsolServicePrincipal atualiza uma entidade de serviço no Microsoft Azure Active Directory. Pode ser utilizado para atualizar o nome de exibição, habilitar/desabilitar o objeto de serviço, a confiança para a delegação, os nomes do objeto de serviço (SPNs) ou os endereços.

Exemplos

Exemplo 1: alterar propriedades em uma entidade de serviço

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

Esse comando atualiza as propriedades na entidade de serviço especificada. Neste exemplo, ele especifica atualizações para o nome de exibição e os SPNs. Isto substituirá qualquer configuração previa.

Exemplo 2: alterar endereços em uma entidade de serviço

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

Esse comando atualiza os endereços de uma entidade de serviço. Neste exemplo, os endereços existentes que foram criados anteriormente ("myApp1.com", "myApp2.com") usando o cmdlet New-MsolServicePrincipalAddresses estão associados à entidade de serviço.

Parâmetros

-AccountEnabled

Esta propriedade está reservada para uso futuro.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Addresses

Especifica a lista de endereços com a qual atualizar e substituir a lista existente. Se você não especificar esse parâmetro, a propriedade existente não será atualizada. Se você especificar uma lista vazia, os endereços existentes serão limpos. Use o cmdlet New-MsolServicePrincipalAddress para ajudar a criar o objeto de lista Addresses.

Tipo:RedirectUri[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AppPrincipalId

Especifica a ID exclusiva do aplicativo associada à entidade de serviço a ser atualizada.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DisplayName

Especifica o nome de exibição da entidade de serviço.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ObjectId

Especifica a ID de objeto exclusiva da entidade de serviço a ser atualizada.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServicePrincipalNames

Especifica a lista de SPNs com as quais atualizar e substituir o existente. Se você não especificar esse parâmetro, a propriedade existente não será atualizada. Se você especificar uma lista vazia, os SPNs existentes serão limpos, exceto pelo SPN que contém o valor AppId da entidade de serviço. Um SPN deve usar um dos seguintes formatos:

  • appName
  • appName/hostname
  • uma URL válida
Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TenantId

Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False