Set-MsolServicePrincipal

  • Referência
Módulo:
MSOnline

Atualizações um diretor de serviços em Microsoft Azure Ative Directory.

Syntax

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

Description

O Cmdlet Set-MsolServicePrincipal atualiza um diretor de serviço em Microsoft Azure Ative Directory. Pode ser utilizado para atualizar o nome de exibição, ativar/desativar o principal de serviço, confiável para a delegação, os nomes principais do serviço (SPNs) ou os endereços.

Exemplos

Exemplo 1: Alterar propriedades num diretor 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 de exibição e para as SPNs. Isto substituirá quaisquer definições anteriores.

Exemplo 2: Alterar endereços num diretor 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 diretor de serviço. Neste exemplo, os endereços existentes que foram previamente criados ("myApp1.com", "myApp2.com") utilizando o cmdlet New-MsolServicePrincipalAddresses , estão associados ao principal do serviço.

Parâmetros

-AccountEnabled

Esta propriedade está reservada para uso futuro.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Addresses

Especifica a lista de endereços com a qual 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 da lista de endereços.

Type:RedirectUri[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AppPrincipalId

Especifica o ID de aplicação único que está associado ao principal do serviço para atualizar.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

Especifica o nome de exibição do principal de serviço.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

Especifica o ID do objeto único do principal de serviço para atualizar.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ServicePrincipalNames

Especifica a lista de SPNs com a qual atualizar e substituir o existente. Se não especificar este parâmetro, a propriedade existente não será atualizada. Se especificar uma lista vazia, as SPNs existentes são apuradas, com exceção da SPN que contém o valor appid do principal serviço. Um SPN deve utilizar um dos seguintes formatos:

  • appName
  • appName/hostname
  • um URL válido
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

Especifica a identificação única do inquilino para realizar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False