Get-EntraSubscription

Moduł:
Microsoft.Entra.DirectoryManagement Module v1.3

Wyświetl listę subskrypcji komercyjnych organizacji.

Składnia

GetQuery (domyślnie) 

Get-EntraSubscription

    [-Top <Int32>]
    [-All]
    [-Filter <String>]
    [-Property <String[]>]
    [<CommonParameters>]

GetById 

Get-EntraSubscription

    -CommerceSubscriptionId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Opis

Polecenie Get-EntraSubscription cmdlet wyświetla listę subskrypcji komercyjnych organizacji.

W scenariuszach delegowanych z kontami służbowymi podczas działania na innym użytkowniku zalogowany użytkownik musi mieć obsługiwaną rolę Microsoft Entra lub rolę niestandardową z niezbędnymi uprawnieniami. Następujące najmniej uprzywilejowane role obsługują tę operację:

  • administrator Dynamics 365 Business Central — właściwości standardowe tylko do odczytu
  • Globalny czytnik
  • Czytelnicy katalogów

Przykłady

Przykład 1. Pobieranie wszystkich subskrypcji komercyjnych organizacji

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraSubscription -All

skuPartNumber          : POWER_BI_STANDARD
ownerId                :
id                     : aaaa0000-bb11-2222-33cc-444444dddddd
nextLifecycleDateTime  : 9/24/2025 11:59:59 PM
ownerType              :
isTrial                : True
ownerTenantId          :
createdDateTime        : 9/24/2023 12:00:00 AM
serviceStatus          : {EXCHANGE_S_FOUNDATION, DYN365_ENTERPRISE_P1_IW}
totalLicenses          : 1
skuId                  : 0000aaaa-11bb-cccc-dd22-eeeeee333333
status                 : Enabled
commerceSubscriptionId : eeeeeeee-4444-5555-6666-ffffffffffff

W tym przykładzie pokazano, jak pobrać określone subskrypcje komercyjne.

Przykład 2. Pobieranie subskrypcji komercyjnych według identyfikatora CommerceSubscriptionId

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraSubscription -CommerceSubscriptionId 'eeeeeeee-4444-5555-6666-ffffffffffff'

skuPartNumber          : POWER_BI_STANDARD
ownerId                :
id                     : aaaa0000-bb11-2222-33cc-444444dddddd
nextLifecycleDateTime  : 9/24/2025 11:59:59 PM
ownerType              :
isTrial                : True
ownerTenantId          :
createdDateTime        : 9/24/2023 12:00:00 AM
serviceStatus          : {EXCHANGE_S_FOUNDATION, DYN365_ENTERPRISE_P1_IW}
totalLicenses          : 1
skuId                  : 0000aaaa-11bb-cccc-dd22-eeeeee333333
status                 : Enabled
commerceSubscriptionId : eeeeeeee-4444-5555-6666-ffffffffffff

W tym przykładzie pokazano, jak pobrać określone subskrypcje komercyjne według .CommerceSubscriptionId

  • -CommerceSubscriptionId parametr określa identyfikator subskrypcji w systemie handlowym.

Przykład 3. Uzyskiwanie dostępnych planów licencji przy użyciu filtrowania

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraSubscription -Filter "id eq 'aaaa0000-bb11-2222-33cc-444444dddddd'"

skuPartNumber          : POWER_BI_STANDARD
ownerId                :
id                     : aaaa0000-bb11-2222-33cc-444444dddddd
nextLifecycleDateTime  : 9/24/2025 11:59:59 PM
ownerType              :
isTrial                : True
ownerTenantId          :
createdDateTime        : 9/24/2023 12:00:00 AM
serviceStatus          : {EXCHANGE_S_FOUNDATION, DYN365_ENTERPRISE_P1_IW}
totalLicenses          : 1
skuId                  : 0000aaaa-11bb-cccc-dd22-eeeeee333333
status                 : Enabled
commerceSubscriptionId : eeeeeeee-4444-5555-6666-ffffffffffff

W tym przykładzie pokazano, jak pobrać określone subskrypcje komercyjne z właściwością filtrowania Id .

Przykład 4. Pobieranie jednostki SKU subskrypcji (jednostka przechowywania magazynu)

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraSubscription -Property skuPartNumber, Status | Select-Object skuPartNumber, Status

skuPartNumber                                                   status
-------------                                                   ------
STREAM                                                          Enabled
EMSPREMIUM                                                      Enabled
UNIVERSAL_PRINT_M365                                            Enabled
Microsoft_365_Copilot                                           Enabled
WINDOWS_STORE                                                   Enabled

W tym przykładzie pokazano, jak pobrać jednostkę SKU subskrypcji. Możesz użyć -Select jako aliasu dla -Property.

Przykład 5. Uzyskiwanie listy aktywnych subskrypcji komercyjnych

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraSubscription |
    Where-Object {
        ($_.Status -ne "Suspended" -and $_.Status -ne "LockedOut") -and
        ($_.NextLifecycleDateTime -ne $null)
    } |
    Sort-Object NextLifecycleDateTime |
    Select-Object *

skuPartNumber          : POWER_BI_STANDARD
ownerId                :
id                     : aaaa0000-bb11-2222-33cc-444444dddddd
nextLifecycleDateTime  : 9/24/2025 11:59:59 PM
ownerType              :
isTrial                : True
ownerTenantId          :
createdDateTime        : 9/24/2023 12:00:00 AM
serviceStatus          : {EXCHANGE_S_FOUNDATION, DYN365_ENTERPRISE_P1_IW}
totalLicenses          : 1000
skuId                  : 0000aaaa-11bb-cccc-dd22-eeeeee333333
status                 : Enabled
commerceSubscriptionId : eeeeeeee-4444-5555-6666-ffffffffffff

W tym przykładzie pokazano, jak pobrać aktywne subskrypcje komercyjne.

Parametry

-All

Wyświetl listę wszystkich stron.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CommerceSubscriptionId

Określa identyfikator subskrypcji w systemie handlowym.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator subskrypcji

Zestawy parametrów

GetById
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Filter

Określa instrukcję filtru OData w wersji 4.0. Ten parametr filtruje zwracane obiekty.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

GetQuery
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Property

Określa właściwości, które mają być zwracane.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Select

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Top

Określa maksymalną liczbę rekordów do zwrócenia.

Właściwości parametru

Typ:System.Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Ograniczenie

Zestawy parametrów

GetQuery
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Notatki

Get-EntraDirectorySubscription to alias dla elementu Get-EntraSubscription.