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.