Dela via

Set-MsolServicePrincipal

  • Referens
Modul:
MSOnline

Uppdaterar tjänstens huvudnamn i Microsoft Azure Active Directory.

Syntax

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

Description

Cmdleten Set-MsolServicePrincipal uppdaterar ett tjänsthuvudnamn i Microsoft Azure Active Directory. Den kan användas för att uppdatera visningsnamnet, aktivera/inaktivera tjänstens huvudnamn, betrodd för delegering, tjänstens huvudnamn (SPN) eller adresserna.

Exempel

Exempel 1: Ändra egenskaper för ett tjänsthuvudnamn

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

Det här kommandot uppdaterar egenskaper för det angivna tjänstens huvudnamn. I det här exemplet anger den uppdateringar av visningsnamnet och SPN:erna. Detta skriver över alla tidigare inställningar.

Exempel 2: Ändra adresser för ett tjänsthuvudnamn

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

Det här kommandot uppdaterar adresserna för ett tjänsthuvudnamn. I det här exemplet associeras befintliga adresser som tidigare skapades ("myApp1.com", "myApp2.com") med cmdleten New-MsolServicePrincipalAddresses med tjänstens huvudnamn.

Parametrar

-AccountEnabled

Den här egenskapen är reserverad för framtida användning.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Addresses

Anger den adresslista som du vill uppdatera och skriva över den befintliga listan med. Om du inte anger den här parametern uppdateras inte den befintliga egenskapen. Om du anger en tom lista rensas de befintliga adresserna. Använd cmdleten New-MsolServicePrincipalAddress för att skapa listobjektet Adresser.

Typ:RedirectUri[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-AppPrincipalId

Anger det unika program-ID som är associerat med tjänstens huvudnamn som ska uppdateras.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DisplayName

Anger visningsnamnet för tjänstens huvudnamn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ObjectId

Anger det unika objekt-ID för tjänstens huvudnamn som ska uppdateras.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ServicePrincipalNames

Anger listan över SPN:er som du vill uppdatera och skriva över den befintliga med. Om du inte anger den här parametern uppdateras inte den befintliga egenskapen. Om du anger en tom lista rensas de befintliga SPN:erna, förutom det SPN som innehåller AppId-värdet för tjänstens huvudnamn. Ett SPN måste använda något av följande format:

  • appName
  • appName/hostname
  • en giltig URL
Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TenantId

Anger det unika ID för klientorganisationen som åtgärden ska utföras på. Standardvärdet är den aktuella användarens klientorganisation. Den här parametern gäller endast för partneranvändare.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False