New-EntraServicePrincipalPasswordCredential

Modul:
Microsoft.Entra.Applications Module v1.3

Erstellt eine Kennwortanmeldeinformationen für einen Dienstprinzipal.

Syntax

Default (Standard) 

New-EntraServicePrincipalPasswordCredential

    -ServicePrincipalId <String>
    [-EndDate <DateTime>]
    [-StartDate <DateTime>]
    [-DisplayName <String>]
    [<CommonParameters>]

Beschreibung

Das New-EntraServicePrincipalPasswordCredential Cmdlet erstellt eine Kennwortanmeldeinformation für einen Dienstprinzipal in Microsoft Entra ID.

Beispiele

Beispiel 1: Erstellen einer Kennwortanmeldeinformationen mit StartDate

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
New-EntraServicePrincipalPasswordCredential -ServicePrincipalId $servicePrincipal.Id -DisplayName 'Helpdesk App Credential' -StartDate '2024-11-04T14:14:14Z'

secretText          : A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u
@odata.type         : #microsoft.graph.servicePrincipal
endDateTime         : 08-08-2026 10:30:00
hint                : LY.
customKeyIdentifier :
startDateTime       : 08-08-2024 14:14:14
keyId               : aaaaaaaa-0b0b-1c1c-2d2d-333333333333
@odata.context      : https://graph.microsoft.com/beta/$metadata#servicePrincipals('00001111-aaaa-2222-bbbb-3333cccc4444')/addPassword
displayName         :
StartDate           : 08-08-2024 14:14:14
EndDate             : 08-08-2026 10:30:00

In diesem Beispiel wird veranschaulicht, wie Sie eine Kennwortanmeldeinformation mit StartDate für einen Dienstprinzipal in Microsoft Entra ID erstellen.

  • -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.
  • -DisplayName der Parameter gibt einen Anzeigenamen für das Kennwort an.
  • -StarteDate der Parameter gibt das Datum und die Uhrzeit an, zu dem das Kennwort gültig wird.

Beispiel 2: Erstellen einer Kennwortanmeldeinformationen mit EndDate

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$servicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
New-EntraServicePrincipalPasswordCredential -ServicePrincipalId $servicePrincipal.Id -DisplayName 'Helpdesk App Credential' -EndDate '2024-11-04T14:14:14Z'

secretText          : A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u
@odata.type         : #microsoft.graph.servicePrincipal
endDateTime         : 08-08-2026 10:30:00
hint                : LY.
customKeyIdentifier :
startDateTime       : 08-08-2024 14:14:14
keyId               : bbbbbbbb-1c1c-2d2d-3e3e-444444444444
@odata.context      : https://graph.microsoft.com/beta/$metadata#servicePrincipals('00001111-aaaa-2222-bbbb-3333cccc4444')/addPassword
displayName         :
StartDate           : 08-08-2024 14:14:14
EndDate             : 08-08-2026 10:30:00

In diesem Beispiel wird veranschaulicht, wie Sie eine Kennwortanmeldeinformationen mit EndDate für einen Dienstprinzipal in Microsoft Entra ID erstellen.

  • -ServicePrincipalId der Parameter gibt die ID eines Dienstprinzipals an.
  • -DisplayName der Parameter gibt einen Anzeigenamen für das Kennwort an.
  • -EndDate der Parameter gibt das Datum und die Uhrzeit an, zu dem das Kennwort abläuft, das im ISO 8601-Format dargestellt wird und sich immer in UTC-Zeit befindet.

Parameter

-DisplayName

Der Anzeigename für das Kennwort.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-EndDate

Das Datum und die Uhrzeit, zu dem das Kennwort abläuft, wird im ISO 8601-Format dargestellt und ist immer in UTC-Zeit angegeben. Mitternacht UTC beispielsweise am 1. Januar 2024 ist 2024-01-01T00:00:00Z.

Parametereigenschaften

Typ:System.DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServicePrincipalId

Gibt die ID des Dienstprinzipals an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StartDate

Das Datum und die Uhrzeit, zu dem das Kennwort gültig wird. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC beispielsweise am 1. Januar 2024 ist 2024-01-01T00:00:00Z.

Parametereigenschaften

Typ:System.DateTime
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

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.