Get-ADGroupMember (Čeština)

Modul: ActiveDirectory

Získá členy skupiny služby Active Directory.

Syntaxe

Popis

Rutina Get-ADGroupMember získává členy skupiny služby Active Directory. Členy mohou být uživatelé, skupiny a počítače.

Parametr Identita určuje skupinu služby Active Directory, ke které chcete přistupovat. Skupinu můžete identifikovat podle rozlišujícího názvu, identifikátoru GUID, identifikátoru zabezpečení nebo názvu účtu Security Account Manager (SAM). Skupinu můžete také určit předáním objektu skupiny prostřednictvím Například pomocí rutiny Get-ADGroup můžete získat objekt skupiny a poté objekt předat potrubím do rutiny Get-ADGroupMember.

Pokud je zadán parametr Rekurzivní, rutina získá všechny členy v hierarchii skupiny, které neobsahují podřízené objekty. Například pokud skupina SaraDavisReports obsahuje uživatele KarenToh a skupinu JohnSmithReports a JohnSmith Reports contains the user JoshPollock, then the cmdlet returns KarenToh and JoshPollock.

V prostředích služby Active Directory Lightweight Directory Services (AD LDS) je nutné zadat parametr Partition, kromě následujících dvou podmínek:

  • Rutina se spouští z jednotky poskytovatele služby Active Directory.
  • Pro prostředí AD LDS je definován výchozí kontext pojmenování nebo oddíl. Chcete-li určit výchozí kontext pojmenování pro prostředí AD LDS, nastavte vlastnost msDS-defaultNamingContext objektu agenta adresářové služby Active Directory (nTDSDSA) pro instanci služby AD LDS.

Příklady

Příklad 1: Získejte všechny členy group

Tento příkaz získá všechny členy skupiny Administrators.

Příklad 2: Získání všech členů skupiny ze všech místních skupin domény

Tento příkaz získá skupinu členové všech místních skupin domény v instanci služby AD LDS.

Příklad 3: Získejte všechny členy skupiny Administrators

Tento příkaz získá všechny členové skupiny skupiny Administrators.

Příklad 4: Získejte členy skupiny včetně členů podřízených skupin

Tento příkaz získá všechny členy skupiny Enterprise Admins včetně členů jakékoli podřízené skupiny.

Parametry

-AuthType

Určuje použitou metodu ověřování. Přijatelné hodnoty pro tento parametr jsou:

  • Negotiate or 0
  • Basic or 1

Výchozí metoda ověřování je Negotiate.

A Secure Sockets Layer (SSL ) pro základní metodu ověřování je vyžadováno připojení.

Typ: ADAuthType
Přijaté hodnoty: Vyjednávat, základní
Pozice: Pojmenováno
Výchozí hodnota: Žádná
Přijmout vstup kanálu: Falešný
Přijměte zástupné znaky: Falešné

-Credential

Určuje přihlašovací údaje uživatelského účtu, které se mají použít k provedení této úlohy. Výchozí přihlašovací údaje jsou přihlašovací údaje aktuálně přihlášeného uživatele, pokud není rutina spuštěna z modulu Active Directory pro jednotku poskytovatele Windows PowerShell. rutina se spouští z takové jednotky poskytovatele, účet přidružený k jednotce je výchozí.

Chcete-li zadat tento parametr, můžete zadat uživatelské jméno, například User1 nebo Domain01 \ User01, nebo můžete zadat Objekt PSCredential. Pokud pro tento parametr zadáte uživatelské jméno, rutina vás vyzve k zadání hesla.

Objekt PSCredential můžete také vytvořit pomocí skriptu nebo pomocí rutiny Get-Credential. Poté můžete nastavte parametr Credential na objekt PSCredential.

Pokud jednající pověření nemají oprávnění k provedení úkolu na úrovni adresáře, modul Active Directory pro Windows PowerShell vrátí chybu ukončení.

Typ: PSCredential
Pozice: pojmenovaná
výchozí hodnota: žádná
Accept pipeline input: False
Accept wildcard characters: False
-Identity

Určuje objekt skupiny služby Active Directory zadáním jedné z následujících hodnot. Identifikátor v závorkách je zobrazení LDAP název atributu. Přijatelné hodnoty pro tento parametr jsou:

  • rozlišující název
  • identifikátor GUID (objectGUID)
  • identifikátor zabezpečení (objectSid )
  • Název účtu bezpečnostního správce účtu (sAMAccountName)

Rutina prohledá výchozí kontext pojmenování nebo oddíl a vyhledá objekt. Jsou-li nalezeny dva nebo více objektů, rutina vrátí nekončící chybu.

Tento parametr může také získat tento objekt potrubím nebo můžete tento parametr nastavit na instanci objektu.

Typ: ADGroup
Pozice: 0
Výchozí hodnota: Žádná
Přijmout vstup kanálu: True
Přijmout zástupné znaky: False
-Partition

Určuje rozlišující název oddílu služby Active Directory. Rozlišující název musí být jedním z pojmenovacích kontextů na aktuálním adresářovém serveru. prohledá tento oddíl a najde objekt definovaný parametrem Identity.

V mnoha případech se pro parametr Partition použije výchozí hodnota, pokud není zadána žádná hodnota. Pravidla pro určení výchozí hodnoty jsou uvedena níže. Všimněte si, že pravidla uvedená jako první jsou vyhodnocena jako první a jakmile bude možné určit výchozí hodnotu, nebudou vyhodnocena žádná další pravidla.

V prostředích služby AD DS (Active Directory Domain Services) je výchozí hodnota pro oddíl nastavena v Následující případy:

  • Pokud je parametr Identita nastaven na rozlišující název, výchozí hodnota oddílu se automaticky vygeneruje z tohoto rozlišujícího názvu.
  • Pokud běží rutiny ze služby Active Directory poskytovatel disk, výchozí hodnota oddílu je automaticky generována z aktuální cesty v jednotce.
  • Pokud neplatí žádný z předchozích případů, je výchozí hodnota oddílu nastavena na výchozí oddíl nebo kontext pojmenování cílová doména.

V prostředích služby Active Directory Lightweight Directory Services (AD LDS) je výchozí hodnota pro oddíl nastavena v následujících případech:

  • Pokud Parametr identity je nastaven na rozlišující název, výchozí hodnota oddílu se automaticky generuje z tohoto rozlišujícího názvu.
  • Pokud běží rutiny z jednotky poskytovatele služby Active Directory, výchozí hodnota oddílu se automaticky generuje z aktuálního cesta v jednotce.
  • Pokud má cílová instance služby AD LDS výchozí hodnotu V kontextu pojmenování je výchozí hodnota oddílu nastavena na výchozí kontext pojmenování. Chcete-li určit výchozí kontext pojmenování pro prostředí AD LDS, nastavte vlastnost msDS-defaultNamingContext objektu agenta adresářové služby Active Directory (nTDSDSA) pro objekt AD LDS. instance.
  • Pokud neplatí žádný z předchozích případů, parametr Partition nemá výchozí hodnotu.
Typ: Řetězec
Pozice: Pojmenovaná
Výchozí hodnota: Žádná
Přijmout vstup kanálu: Falešný
Přijmout zástupné znaky: Falešné
-Recursive

Určuje, že rutina získá všechny členy v hierarchii skupiny, které neobsahují podřízené objekty.

Pokud zadaná skupina nemá žádné členy, nic se nevrátí.

Typ: SwitchParam eter
Pozice: pojmenovaná
výchozí hodnota: žádná
Přijmout vstup kanálu: Falešně
Přijmout zástupné znaky: False
-Server

Určuje instanci služby AD DS, ke které se chcete připojit, poskytnutím jedné z následujících hodnot pro odpovídající název domény nebo adresářový server. Službou může být kterákoli z následujících: Instance snímku AD LDS, AD DS nebo Active Directory.

Zadejte instanci služby AD DS v jedním z následujících způsobů:

Hodnoty názvu domény:

  • Plně kvalifikovaný název domény
  • Název NetBIOS

Hodnoty adresářového serveru:

  • Plně kvalifikovaný název adresářového serveru
  • Název NetBIOS
  • Plně kvalifikovaný název adresářového serveru a port

Výchozí hodnota pro tento parametr je určena jednou z následujících metod v pořadí, v jakém jsou uvedeny:

  • Autorem g hodnota serveru z objektů předaných potrubím
  • pomocí informací o serveru přidružených k jednotce poskytovatele služby AD DS Windows PowerShell, když je rutina spuštěna v této jednotce,
  • pomocí domény počítače se systémem Windows PowerShell
Typ: Řetězec
Pozice: Pojmenováno
Výchozí hodnota: Žádná
Přijmout vstup kanálu: False
Přijmout zástupné znaky: False

Vstupy

Žádné nebo Microsoft.ActiveDirectory.Management.ADGroup

Objekt skupiny je přijat parametr Identita.

Výstupy

ADPrincipal

Vrátí jeden nebo více hlavních objektů, které představují uživatele, počítače nebo skupiny, které jsou členy určené skupiny.

Poznámky

  • Tato rutina nefunguje se snímkem služby Active Directory.
  • Tato rutina nefunguje, pokud má skupina členy umístěné v jiné doménové struktuře a v doménové struktuře není spuštěna služba Active Directory Web Service.
  • Přidat -ADGroupMember
  • Add-ADPrincipalGroupMembership
  • Get-ADGroup
  • Get-ADPrincipalGroupMembership
  • Remove-ADGroupMember
  • Remove -ADPrincipalGroupMembership

Napsat komentář

Vaše e-mailová adresa nebude zveřejněna. Vyžadované informace jsou označeny *