Freigeben über

Set-MsolServicePrincipal

  • Referenz
Modul:
MSOnline

Aktualisiert einen Dienstprinzipal in Microsoft Azure Active Directory.

Syntax

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

Beschreibung

Das Cmdlet Set-MsolServicePrincipal aktualisiert einen Dienstprinzipal in Microsoft Azure Active Directory. Es kann zum Aktualisieren des Anzeigenamens, Aktivieren/Deaktivieren des Dienstprinzipals, des Vertrauensstatus für Delegierungszwecke, der Dienstprinzipalnamen (Service Principal Name, SPN) oder der Adressen verwendet werden.

Beispiele

Beispiel 1: Ändern von Eigenschaften für einen Dienstprinzipal

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

Dieser Befehl aktualisiert die Eigenschaften für den angegebenen Dienstprinzipal. In diesem Beispiel werden Updates für den Anzeigenamen und die SPNs angegeben. Dadurch werden die jeweils früheren Einstellungen überschrieben.

Beispiel 2: Ändern von Adressen für einen Dienstprinzipal

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

Dieser Befehl aktualisiert die Adressen eines Dienstprinzipals. In diesem Beispiel werden vorhandene Adressen, die zuvor mit dem Cmdlet New-MsolServicePrincipalAddresses erstellt wurden ("myApp1.com", "myApp2.com"), dem Dienstprinzipal zugeordnet.

Parameter

-AccountEnabled

Diese Eigenschaft ist für eine spätere Verwendung vorgesehen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Addresses

Gibt die Adressenliste an, mit der die vorhandene Liste aktualisiert und überschrieben werden soll. Wenn Sie diesen Parameter nicht angeben, wird die vorhandene Eigenschaft nicht aktualisiert. Wenn Sie eine leere Liste angeben, werden die vorhandenen Adressen gelöscht. Verwenden Sie das Cmdlet New-MsolServicePrincipalAddress , um das Adressenlistenobjekt zu erstellen.

Typ:RedirectUri[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AppPrincipalId

Gibt die eindeutige Anwendungs-ID an, die dem zu aktualisierenden Dienstprinzipal zugeordnet ist.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt den Anzeigenamen des Dienstprinzipals an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ObjectId

Gibt die eindeutige Objekt-ID des zu aktualisierenden Dienstprinzipals an.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServicePrincipalNames

Gibt die Liste der SPNs an, mit denen die vorhandenen aktualisiert und überschrieben werden sollen. Wenn Sie diesen Parameter nicht angeben, wird die vorhandene Eigenschaft nicht aktualisiert. Wenn Sie eine leere Liste angeben, werden die vorhandenen SPNs gelöscht, mit Ausnahme des SPNs, der den AppId-Wert des Dienstprinzipals enthält. Ein SPN muss eines der folgenden Formate verwenden:

  • appName
  • appName/hostname
  • eine gültige URL
Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TenantId

Gibt die eindeutige ID des Mandanten an, auf dem der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False