Megosztás a következőn keresztül:


Get-MsolServicePrincipal

Lekéri a szolgáltatásneveket az Azure Active Directoryból.

Syntax

Get-MsolServicePrincipal
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -AppPrincipalId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   -ServicePrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolServicePrincipal
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

A Get-MsolServicePrincipal parancsmag lekéri a szolgáltatásnevet vagy a szolgáltatásnevek listáját az Azure Active Directoryból.

Példák

1. példa: Az összes szolgáltatásnév megjelenítése

PS C:\> Get-MsolServicePrincipal

Ez a parancs megjeleníti a szervezet bérlőjében található összes meglévő szolgáltatásnevet.

2. példa: Szolgáltatásnevek lekérése névvel

PS C:\> Get-MsolServicePrincipal -ServicePrincipalName "MyApp"

Ez a parancs lekéri az összes meglévő szolgáltatásnevet, amely a MyApp kezdetű szolgáltatásnévvel rendelkezik. Ez pontosan megegyezik a szolgáltatásnév appClass részével a perjelig.

3. példa: Szolgáltatásnév lekérése

PS C:\> Get-MsolServicePrincipal -AppPrincipalId 5e964d2f-e384-4292-ae55-dd24c89cc53b

Ez a parancs lekéri a szolgáltatásnevet, amely egy adott alkalmazásnév-azonosítóval rendelkezik.

Paraméterek

-All

Azt jelzi, hogy ez a parancsmag az összes eredményt visszaadja. Ne adja meg együtt a MaxResults paramétert.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AppPrincipalId

Megadja a lekérni kívánt szolgáltatásnév egyedi alkalmazásazonosítóját.

Típus:Guid
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-MaxResults

A parancsmag által visszaadott eredmények maximális számát adja meg. Az alapértelmezett érték: 500.

Típus:Int32
Position:Named
Alapértelmezett érték:500
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ObjectId

Megadja a lekérni kívánt szolgáltatásnév egyedi objektumazonosítóját.

Típus:Guid
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-SearchString

Egy sztringet ad meg, amely megegyezik a szolgáltatásnévvel.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ServicePrincipalName

Megadja a lekérni kívánt szolgáltatásnév vagy szolgáltatásnevek nevét. Az egyszerű szolgáltatásneveknek a következő formátumok egyikét kell használniuk:

  • appName
  • appName/hostname
  • érvényes URL-cím

Az AppName az alkalmazás nevét, az állomásnév pedig az alkalmazás URI-szolgáltatóját jelöli.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-TenantId

Annak a bérlőnek az egyedi azonosítóját adja meg, amelyen a műveletet végre szeretné hajtani. Az alapértelmezett érték az aktuális felhasználó bérlője. Ez a paraméter csak a partnerfelhasználókra vonatkozik.

Típus:Guid
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

Kimenetek

Microsoft.Online.Administration.ServicePrincipal[]

Ez a parancsmag egy szolgáltatásnevet vagy szolgáltatásnevek listáját adja vissza az Azure Active Directoryból. Minden szolgáltatásnév a következő információkat tartalmazza:

  • ObjectId. A szolgáltatásnév egyedi azonosítója.
  • AppPrincipalId. A szolgáltatásnév alkalmazásazonosítója.
  • Displayname. A szolgáltatásnév rövid neve.
  • ServicePrincipalName. A szolgáltatásnévhez társított egyszerű szolgáltatásnevek (SPN-ek) listája.
  • AccountEnabled. Az érték, amely jelzi, hogy a fiók engedélyezve van-e.