Set-EntraServicePrincipal

Set-EntraServicePrincipal

    -ServicePrincipalId <String>
    [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
    [-Homepage <String>]
    [-AppId <String>]
    [-LogoutUrl <String>]
    [-ServicePrincipalType <String>]
    [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
    [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
    [-PreferredSingleSignOnMode <String>]
    [-Tags <System.Collections.Generic.List`1[System.String]>]
    [-AccountEnabled <String>]
    [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
    [-AppRoleAssignmentRequired <Boolean>]
    [-DisplayName <String>]
    [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
    [<CommonParameters>]

Das Set-EntraServicePrincipal Cmdlet aktualisiert einen Dienstprinzipal in Microsoft Entra ID.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -AccountEnabled $false

In diesem Beispiel wird veranschaulicht, wie ein Dienstprinzipal in Microsoft Entra ID aktualisiert AccountEnabled wird.

• -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.
• -AccountEnabled der Parameter gibt an, ob das Konto aktiviert ist.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
$homePage = 'https://*.e-days.com/SSO/SAML2/SP/AssertionConsumer.aspx?metadata=e-days|ISV9.2|primary|z'
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -Homepage $homePage

In diesem Beispiel wird das Aktualisieren AppId und Die Homepage eines Dienstprinzipals in Microsoft Entra ID veranschaulicht.

• -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.
• -AppId der Parameter gibt die Anwendungs-ID an.
• -Homepage der Parameter gibt die Startseite oder Startseite der Anwendung an.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -AlternativeNames 'Helpdesk Application Global' -DisplayName 'NewName'

In diesem Beispiel wird veranschaulicht, wie AlternativeNames und DisplayName eines Dienstprinzipals in Microsoft Entra ID aktualisiert werden.

• -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
$logoutUrl = 'https://securescore.office.com/SignOut'
$replyUrls = 'https://admin.contoso.com'
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -LogoutUrl $logoutUrl -ReplyUrls $replyUrls

In diesem Beispiel wird veranschaulicht, wie LogoutUrl und ReplyUrls eines Dienstprinzipals in Microsoft Entra ID aktualisiert werden.

• -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.
• -LogoutUrl der Parameter gibt die Abmelde-URL an.
• -ReplyUrls der Parameter gibt die URLs an, an die Benutzertoken für die Anmeldung mit der zugehörigen Anwendung gesendet werden.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -ServicePrincipalType 'Application' -AppRoleAssignmentRequired $True

In diesem Beispiel wird veranschaulicht, wie ein Dienstprinzipal in Microsoft Entra ID aktualisiert ServicePrincipalType wirdAppRoleAssignmentRequired.

• -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.
• -ServicePrincipalType der Parameter gibt den Dienstprinzipaltyp an.
• -AppRoleAssignmentRequired Der Parameter gibt an, ob eine Anwendungsrollenzuweisung erforderlich ist.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
$creds = New-Object Microsoft.Open.AzureAD.Model.KeyCredential
$creds.CustomKeyIdentifier = [System.Text.Encoding]::UTF8.GetBytes('Test')
$startdate = Get-Date -Year 2024 -Month 10 -Day 10
$creds.StartDate = $startdate
$creds.Type = 'Symmetric'
$creds.Usage = 'Sign'
$creds.Value = [System.Text.Encoding]::UTF8.GetBytes('A')
$creds.EndDate = Get-Date -Year 2025 -Month 12 -Day 20
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -KeyCredentials $creds

In diesem Beispiel wird veranschaulicht, wie KeyCredentials eines Dienstprinzipals in Microsoft Entra ID aktualisiert wird.

Verwenden Sie die New-EntraServicePrincipalPasswordCredential Cmdlets, Remove-EntraServicePrincipalPasswordCredential um das Kennwort oder den geheimen Schlüssel für einen servicePrincipal zu aktualisieren.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -PreferredSingleSignOnMode 'saml'

In diesem Beispiel wird veranschaulicht, wie ein Dienstprinzipal in Microsoft Entra ID aktualisiert PreferredSingleSignOnMode wird.

• -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.
• -PreferredSingleSignOnMode der Parameter gibt den modus für einmaliges Anmelden an, der für diese Anwendung konfiguriert ist.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.