Partilhar via

Set-MsolServicePrincipal

  • Referência
Módulo:
MSOnline

Atualiza um principal 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 um principal de serviço no Microsoft Azure Active Directory. Pode ser utilizado para atualizar o nome a apresentar, ativar/desativar o principal de serviço, fidedigno para delegação, os nomes dos principais de serviço (SPNs) ou os endereços.

Exemplos

Exemplo 1: Alterar propriedades num principal 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")

Este comando atualiza as propriedades no principal de serviço especificado. Neste exemplo, especifica atualizações para o nome a apresentar e os SPNs. Esta ação substituirá quaisquer definições anteriores.

Exemplo 2: Alterar endereços num principal 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

Este comando atualiza os endereços de um principal de serviço. Neste exemplo, os Endereços existentes que foram criados anteriormente ("myApp1.com", "myApp2.com") com o cmdlet New-MsolServicePrincipalAddresses estão associados ao principal de serviço.

Parâmetros

-AccountEnabled

Esta propriedade está reservada para utilização futura.

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

-Addresses

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

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

-AppPrincipalId

Especifica o ID de aplicação exclusivo que está associado ao principal de serviço a atualizar.

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

-DisplayName

Especifica o nome a apresentar do principal de serviço.

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

-ObjectId

Especifica o ID de objeto exclusivo do principal de serviço a atualizar.

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

-ServicePrincipalNames

Especifica a lista de SPNs com os quais pretende atualizar e substituir o existente. Se não especificar este parâmetro, a propriedade existente não será atualizada. Se especificar uma lista vazia, os SPNs existentes serão limpos, exceto o SPN que contém o valor AppId do principal de serviço. Um SPN tem de utilizar um dos seguintes formatos:

  • appName
  • appName/hostname
  • um URL válido
Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TenantId

Especifica o ID exclusivo do inquilino no qual efetuar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

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