Get-EntraBetaDirectorySetting

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

Pobiera ustawienie katalogu.

Składnia

GetQuery (domyślnie) 

Get-EntraBetaDirectorySetting

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

GetById 

Get-EntraBetaDirectorySetting

    -Id <String>
    [-All]
    [-Property <String[]>]
    [<CommonParameters>]

Opis

Polecenie Get-EntraBetaDirectorySetting cmdlet pobiera ustawienie katalogu z Microsoft Entra ID. Określ Id parametr, aby uzyskać ustawienie katalogu.

W scenariuszach delegowanych z kontami służbowymi zalogowany użytkownik musi mieć przypisaną obsługiwaną rolę Microsoft Entra lub rolę niestandardową z obsługiwanym uprawnieniem roli. Obsługiwane są następujące najmniej uprzywilejowane role:

  • Microsoft Entra administrator lokalny urządzenia przyłączonego (odczyt podstawowych właściwości ustawień i szablonów ustawień)
  • Czytelnicy katalogów (odczytywanie podstawowych właściwości ustawień i szablonów)
  • Czytelnik globalny (odczytywanie podstawowych właściwości ustawień i szablonów)
  • Administrator grup (zarządzaj wszystkimi ustawieniami grupy)
  • Autorzy katalogów (zarządzaj wszystkimi ustawieniami grupy)
  • Administrator zasad uwierzytelniania (aktualizowanie ustawień reguły haseł)
  • Administrator użytkowników (odczytywanie podstawowych właściwości ustawień i szablonów)

Przykłady

Przykład 1. Pobieranie ustawienia katalogu

Connect-Entra -Scopes 'Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All'
Get-EntraBetaDirectorySetting -Id 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'

Id                                   DisplayName            TemplateId
--                                   -----------            ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Application            00001111-aaaa-2222-bbbb-3333cccc4444

Ten przykład pobiera ustawienie katalogu.

  • -Id parametr określa identyfikator katalogu.

Przykład 2. Pobieranie wszystkich ustawień katalogu

Connect-Entra -Scopes 'Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All'
Get-EntraBetaDirectorySetting -All

Id                                   DisplayName            TemplateId
--                                   -----------            ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Application            00001111-aaaa-2222-bbbb-3333cccc4444
bbbbbbbb-1111-2222-3333-cccccccccccc Password Rule Settings 11112222-bbbb-3333-cccc-4444dddd5555

Ten przykład pobiera wszystkie ustawienia katalogu.

Przykład 3. Pobieranie ustawienia katalogu top n

Connect-Entra -Scopes 'Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All'
Get-EntraBetaDirectorySetting -Top 2

Id                                   DisplayName            TemplateId
--                                   -----------            ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Application            00001111-aaaa-2222-bbbb-3333cccc4444
bbbbbbbb-1111-2222-3333-cccccccccccc Password Rule Settings 11112222-bbbb-3333-cccc-4444dddd5555

Ten przykład pobiera dwa pierwsze ustawienie katalogu. Możesz użyć -Limit jako aliasu dla -Top.

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

-Id

Określa identyfikator katalogu w Microsoft Entra ID.

Właściwości parametru

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

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

-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:True
Wartość z potoku według nazwy właściwości:True
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.