Get-EntraUserExtension

Modul:
Microsoft.Entra.Users Module v1.3

Ruft die Erweiterung eines Benutzers ab.

Syntax

Default (Standard) 

Get-EntraUserExtension

    -UserId <String>
    [-Property <String[]>]
    [-IsSyncedFromOnPremises <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Get-EntraUserExtension Cmdlet ruft Erweiterungen für einen Benutzer in Microsoft Entra ID ab.

Beispiele

Beispiel 1: Abrufen von Erweiterungsattributen für einen Benutzer

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserExtension -UserId 'SawyerM@contoso.com'

id                          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
userPrincipalName           : sawyerm@contoso.com
employeeId                  :
identities                  : {@{signInType=userPrincipalName; issuer=contoso.com; issuerAssignedId=sawyerm@contoso.com}}
onPremisesDistinguishedName :
createdDateTime             : 3/7/2024 12:34:59 AM
userIdentities              : {@{signInType=userPrincipalName; issuer=contoso.com; issuerAssignedId=sawyerm@contoso.com}}

In diesem Beispiel wird gezeigt, wie die Erweiterungsattribute für einen angegebenen Benutzer abgerufen werden.

  • -UserId der Parameter gibt die Benutzerobjekt-ID an.

Beispiel 2: Abrufen von Erweiterungsattributen für einen Benutzer, der von lokal synchronisiert wurde

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserExtension -UserId 'SawyerM@contoso.com' -IsSyncedFromOnPremises $true

id                          : aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
userPrincipalName           : sawyerm@contoso.com
employeeId                  :
identities                  : {@{signInType=userPrincipalName; issuer=contoso.com; issuerAssignedId=sawyerm@contoso.com}}
onPremisesDistinguishedName :
createdDateTime             : 3/7/2024 12:34:59 AM
userIdentities              : {@{signInType=userPrincipalName; issuer=contoso.com; issuerAssignedId=sawyerm@contoso.com}}

In diesem Beispiel wird gezeigt, wie die Erweiterungsattribute für einen angegebenen Benutzer abgerufen werden, deren Erweiterungen von der lokalen Bereitstellung synchronisiert werden.

  • -UserId der Parameter gibt die Benutzerobjekt-ID an.

Parameter

-IsSyncedFromOnPremises

Filtern, um nur die erweiterungen anzuzeigen, die von der lokalen Bereitstellung synchronisiert wurden.

Parametereigenschaften

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

Parametersätze

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

-Property

Gibt eigenschaften an, die zurückgegeben werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Select

Parametersätze

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

-UserId

Gibt die ID eines Objekts an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID, UPN (Benutzerprinzipalname), Identity, Benutzerhauptname

Parametersätze

(All)
Position:Named
Obligatorisch:True
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.