Set-MsolServicePrincipal

  • Referentie
Module:
MSOnline

Updates een service-principal in Microsoft Azure Active Directory.

Syntax

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

Description

Met de cmdlet Set-MsolServicePrincipal wordt een service-principal in Microsoft Azure Active Directory bijgewerkt. Het kan worden gebruikt om de weergavenaam bij te werken, de service-principal in of uit te schakelen, vertrouwd voor delegering, de namen van de service-principals (SPN's) of de adressen.

Voorbeelden

Voorbeeld 1: Eigenschappen van een service-principal wijzigen

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")

Met deze opdracht worden eigenschappen bijgewerkt voor de opgegeven service-principal. In dit voorbeeld worden updates voor de weergavenaam en de SPN's opgegeven. Hiermee worden eventuele eerdere instellingen overschreven.

Voorbeeld 2: Adressen wijzigen in een service-principal

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

Met deze opdracht worden de adressen van een service-principal bijgewerkt. In dit voorbeeld zijn bestaande adressen die eerder zijn gemaakt ('myApp1.com', 'myApp2.com') met behulp van de cmdlet New-MsolServicePrincipalAddresses gekoppeld aan de service-principal .

Parameters

-AccountEnabled

Deze eigenschap is gereserveerd voor toekomstig gebruik.

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

-Addresses

Hiermee geeft u de adressenlijst op waarmee de bestaande lijst moet worden bijgewerkt en overschreven. Als u deze parameter niet opgeeft, wordt de bestaande eigenschap niet bijgewerkt. Als u een lege lijst opgeeft, worden de bestaande adressen gewist. Gebruik de cmdlet New-MsolServicePrincipalAddress om het lijstobject Adressen te maken.

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

-AppPrincipalId

Hiermee geeft u de unieke toepassings-id op die is gekoppeld aan de service-principal die moet worden bijgewerkt.

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

-DisplayName

Hiermee geeft u de weergavenaam van de service-principal op.

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

-ObjectId

Hiermee geeft u de unieke object-id van de service-principal die moet worden bijgewerkt.

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

-ServicePrincipalNames

Hiermee geeft u de lijst met SPN's waarmee de bestaande moet worden bijgewerkt en overschreven. Als u deze parameter niet opgeeft, wordt de bestaande eigenschap niet bijgewerkt. Als u een lege lijst opgeeft, worden de bestaande SPN's gewist, met uitzondering van de SPN die de AppId-waarde van de service-principal bevat. Een SPN moet een van de volgende indelingen gebruiken:

  • appName
  • appName/hostname
  • een geldige URL
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

Hiermee geeft u de unieke id van de tenant op waarop de bewerking moet worden uitgevoerd. De standaardwaarde is de tenant van de huidige gebruiker. Deze parameter is alleen van toepassing op partnergebruikers.

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