Set-MsolServicePrincipal

  • Referenz
Modul:
MSOnline

Aktualisierungen ein 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 in einem 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 Eigenschaften für den angegebenen Dienstprinzipal. In diesem Beispiel wird Updates für den Anzeigenamen und die SPNs angegeben. Dadurch werden die jeweils früheren Einstellungen überschrieben.

Beispiel 2: Ändern von Adressen in einem 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 ("myApp1.com", "myApp2.com") mithilfe des Cmdlets New-MsolServicePrincipalAddresses erstellt wurden, dem Dienstprinzipal zugeordnet.

Parameter

-AccountEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-AppPrincipalId

Gibt die eindeutige Anwendungs-ID an, die dem Dienstprinzipal zugeordnet ist, um das Update zu aktualisieren.

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

-DisplayName

Gibt den Anzeigenamen des Dienstprinzipals an.

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

-ObjectId

Gibt die eindeutige Objekt-ID des Dienstprinzipals an, die aktualisiert werden soll.

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

-ServicePrincipalNames

Gibt die Liste der SPNs an, mit denen das vorhandene Update 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 SPNs gelöscht, außer für die SPN, die den AppId-Wert des Dienstprinzipals enthält. Ein SPN muss ein der folgenden Formate verwenden:

  • appName
  • appName/hostname
  • eine gültige URL
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TenantId

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

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