Set-MsolServicePrincipal

  • Referens
Modul:
MSOnline

Uppdateringar ett huvudnamn för tjänsten 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 tjänstens huvudnamn i Microsoft Azure Active Directory. Den kan användas för att uppdatera visningsnamnet, aktivera/inaktivera tjänstens huvudnamn, betrott för delegering, tjänstens huvudnamn (SPN) eller adresserna.

Exempel

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

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 huvudnamn för tjänsten

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 huvudnamn för tjänsten. I det här exemplet associeras befintliga adresser som tidigare har skapats ("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.

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

-Addresses

Anger adresslistan 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.

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

-AppPrincipalId

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

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

-DisplayName

Anger visningsnamnet för tjänstens huvudnamn.

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

-ObjectId

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

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

-ServicePrincipalNames

Anger listan med SPN:er som du vill uppdatera och skriva över befintliga. 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
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

Anger det unika ID:t för den klientorganisation 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.

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