Get-ADGroupMember (Norsk)

Modul: ActiveDirectory

Får medlemmene i en Active Directory-gruppe.

Syntaks

Beskrivelse

Get-ADGroupMember cmdlet får medlemmene i en Active Directory-gruppe. Medlemmer kan være brukere, grupper og datamaskiner.

Identitetsparameteren angir Active Directory-gruppen du vil få tilgang til. Du kan identifisere en gruppe med dens særpregede navn, GUID, sikkerhetsidentifikator eller SAMM-kontonavn (SAM). Du kan også spesifisere gruppen ved å sende et gruppeobjekt gjennom rørledningen. For eksempel kan du bruke Get-ADGroup cmdlet for å hente et gruppeobjekt og deretter sende objektet gjennom rørledningen til cmdleten Get-ADGroupMember.

Hvis den rekursive parameteren er spesifisert, er cmdleten får alle medlemmene i hierarkiet til gruppen som ikke inneholder underordnede objekter. For eksempel hvis gruppen SaraDavisReports inneholder brukeren KarenToh og gruppen JohnSmithReports og JohnSmith Rapporter inneholder brukeren JoshPollock, og deretter returnerer cmdleten KarenToh og JoshPollock.

For Active Directory Lightweight Directory Services (AD LDS) -miljøer, må Partisjon-parameteren spesifiseres bortsett fra i følgende to forhold:

  • cmdleten kjøres fra en Active Directory-leverandørstasjon.
  • En standard navnekontekst eller partisjon er definert for AD LDS-miljøet. For å spesifisere en standard navnekontekst for et AD LDS-miljø, angi egenskapen msDS-defaultNamingContext til Active Directory-katalogtjenesteagentobjektet (nTDSDSA) for AD LDS-forekomsten.

Eksempler

Eksempel 1: Få alle medlemmene i en gruppe

Denne kommandoen henter alle medlemmene i administratorgruppen.

Eksempel 2: Få alle gruppemedlemmene i alle lokale domenegrupper

Denne kommandoen henter gruppen medlemmer av alle lokale domenegrupper i AD LDS-forekomsten.

Eksempel 3: Få alle administratorgruppemedlemmene

Denne kommandoen får alle gruppemedlemmer i administratorgruppen.

Eksempel 4: Få medlemmer av en gruppe inkludert medlemmene av underordnede grupper

Denne kommandoen får alle medlemmene av Enterprise Admins-gruppen inkludert medlemmene av eventuelle underordnede grupper.

Parametere

-AuthType

Spesifiserer autentiseringsmetoden som skal brukes. De akseptable verdiene for denne parameteren er:

  • Forhandle eller 0
  • Grunnleggende eller 1

Standardgodkjenningsmetoden er Forhandle.

Et Secure Sockets Layer (SSL ) tilkobling kreves for den grunnleggende autentiseringsmetoden.

Type: ADAuthType
Aksepterte verdier: Forhandle, grunnleggende
Posisjon: Navngitt
Standardverdi: Ingen
Godta rørinngang: Falsk
Godta jokertegn: Falsk

-Preferanse

Spesifiserer brukerkontolegitimasjonen som skal brukes til å utføre denne oppgaven. Standardlegitimasjonsinformasjonen er legitimasjonen til den påloggede brukeren med mindre cmdlet kjøres fra en Active Directory-modul for Windows PowerShell-leverandørstasjon. cmdlet kjøres fra en slik leverandørstasjon, er kontoen som er knyttet til stasjonen som standard.

For å spesifisere denne parameteren kan du skrive inn et brukernavn, for eksempel User1 eller Domain01 \ User01, eller du kan spesifisere en PSCredential-objekt. Hvis du angir et brukernavn for denne parameteren, blir cmdleten bedt om et passord.

Du kan også opprette et PSCredential-objekt ved å bruke et skript eller ved å bruke Get-Credential-cmdleten. Du kan deretter angi legitimasjonsparameteren til PSCredential-objektet.

Hvis de fungerende legitimasjonene ikke har tillatelse på katalognivå til å utføre oppgaven, returnerer Active Directory-modulen for Windows PowerShell en avslutningsfeil.

Type: PSCredential
Posisjon: Navngitt
Standardverdi: Ingen
Godta rørinngang: Falsk
Godta jokertegn: Falsk
-Identitet

Spesifiserer et Active Directory-gruppeobjekt ved å oppgi en av følgende verdier. Identifikatoren i parentes er LDAP-skjermen navn for attributtet. De akseptable verdiene for denne parameteren er:

  • Et fremtredende navn
  • En GUID (objectGUID)
  • En sikkerhetsidentifikator (objectSid )
  • Et kontonavn for et sikkerhetskontoadministrasjonskonto (sAMAccountName)

cmdlet søker i standard navnekontekst eller partisjon for å finne objektet. Hvis to eller flere objekter blir funnet, cmdleten returnerer en ikke-avsluttende feil.

Denne parameteren kan også få dette objektet gjennom rørledningen, eller du kan sette denne parameteren til en objektforekomst.

Type: ADGroup
Posisjon: 0
Standardverdi: Ingen
Godta rørinngang: True
Godta jokertegn: False
-Partition

Spesifiserer det fremtredende navnet på en Active Directory-partisjon. Det fremtredende navnet må være en av navnekontekstene på den nåværende katalogserveren. søker i denne partisjonen for å finne objektet definert av parameteren Identity.

I mange tilfeller brukes en standardverdi for Partition-parameteren hvis ingen verdi er spesifisert. Reglene for å bestemme standardverdien er gitt nedenfor. Merk at reglene som er oppført først blir evaluert først, og når en standardverdi kan bestemmes, blir ingen ytterligere regler evaluert.

I Active Directory Domain Services (AD DS) -miljøer er en standardverdi for Partition satt i følgende tilfeller:

  • Hvis identitetsparameteren er satt til et fremtredende navn, genereres standardverdien for partisjon automatisk fra dette unike navnet.
  • Hvis du kjører cmdlets fra en Active Directory leverandørstasjon genereres standardverdien for Partition automatisk fra den nåværende banen i stasjonen.
  • Hvis ingen av de tidligere tilfellene gjelder, er standardverdien for Partition satt til standardpartisjonen eller navnekonteksten til måldomenet.

I Active Directory Lightweight Directory Services (AD LDS) -miljøer angis en standardverdi for Partition i følgende tilfeller:

  • Hvis Identitetsparameter er satt til et fremtredende navn, standardverdien for Partition genereres automatisk fra dette særpregede navnet.
  • Hvis du kjører cmdlets fra en Active Directory-leverandørstasjon, genereres standardverdien for Partition automatisk fra gjeldende bane i stasjonen.
  • Hvis målet AD LDS-forekomst har en standard for å navngi kontekst, er standardverdien for Partition satt til standard navngivningskontekst. For å spesifisere en standard navngivningskontekst for et AD LDS-miljø, angir du msDS-defaultNamingContext-egenskapen til Active Directory-katalogtjenesteagentobjektet (nTDSDSA) for AD LDS forekomst.
  • Hvis ingen av de tidligere tilfellene gjelder, tar ikke partisjonsparameteren en standardverdi.
Type: Streng
Posisjon: Navngitt
Standardverdi: Ingen
Godta rørinngang: Falsk
Godta jokertegn: Falsk
-Rekursiv

Spesifiserer at cmdleten får alle medlemmene i hierarkiet til en gruppe som ikke inneholder underordnede objekter.

Hvis den angitte gruppen ikke har noen medlemmer, returneres ingenting.

Type: SwitchParam eter
Posisjon: Navngitt
Standardverdi: Ingen
Godta rørinngang: Falsk
Godta jokertegn: False
-Server

Spesifiserer AD DS-forekomsten å koble til, ved å oppgi en av følgende verdier for et tilsvarende domenenavn eller katalogserver. Tjenesten kan være en av følgende: AD LDS, AD DS eller Active Directory snapshot-forekomst.

Spesifiser AD DS-forekomsten i en av følgende måter:

Domenenavnverdier:

  • Fullt kvalifisert domenenavn
  • NetBIOS-navn

Katalogserververdier:

  • Fullt kvalifisert katalogservernavn
  • NetBIOS-navn
  • Fullt kvalifisert katalogservernavn og port

Standardverdien for denne parameteren bestemmes av en av følgende metoder i den rekkefølgen de er oppført:

  • Av usin g Serververdien fra objekter som sendes gjennom rørledningen
  • Ved å bruke serverinformasjonen tilknyttet AD DS Windows PowerShell-leverandørstasjonen, når cmdlet kjøres i den stasjonen
  • Ved å bruke domenet på datamaskinen som kjører Windows PowerShell
Type: Streng
Posisjon: Navngitt
Standardverdi: Ingen
Godta rørinngang: Falsk
Godta jokertegn: Falsk

Innganger

Ingen eller Microsoft.ActiveDirectory.Management.ADGroup

Et gruppeobjekt mottas av identitetsparameteren.

Utganger

ADPrincipal

Returnerer ett eller flere hovedobjekter som representerer brukere, datamaskiner eller grupper som er medlemmer av den spesifiserte gruppen.

Merknader

  • Denne cmdleten fungerer ikke med et Active Directory-øyeblikksbilde.
  • Denne cmdleten fungerer ikke når en gruppe har medlemmer i en annen skog, og skogen ikke har Active Directory Web Service kjørt.
  • Legg til -ADGroupMember
  • Add-ADPrincipalGroupMembership
  • Get-ADGroup
  • Get-ADPrincipalGroupMembership
  • Fjern-ADGroupMember
  • Fjern -ADPrincipalGroupMembership

Legg igjen en kommentar

Din e-postadresse vil ikke bli publisert. Obligatoriske felt er merket med *