Delen via


Set-MsolServicePrincipal

Hiermee wordt een service-principal in Microsoft Azure Active Directory bijgewerkt.

Syntaxis

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

Description

De cmdlet Set-MsolServicePrincipal werkt een service-principal bij in Microsoft Azure Active Directory. Deze kan worden gebruikt om de weergavenaam bij te werken, de service-principal in of uit te schakelen, de spn's (service-principalnamen) of de adressen in of uit te schakelen.

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 de eigenschappen van de opgegeven service-principal bijgewerkt. In dit voorbeeld worden updates voor de weergavenaam en de SPN's opgegeven. Hiermee worden eventuele eerdere instellingen overschreven.

Voorbeeld 2: Adressen van een service-principal wijzigen

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 worden 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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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 adressenlijstobject te maken.

Type:RedirectUri[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de weergavenaam van de service-principal.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False