PowerShell 获取 ADGroup | PowerShell Get-ADGroup 示例

PowerShell Get-ADGroup 简介

以下文章提供了 PowerShell Get-ADGroup 的概述。 Get-ADGroup cmdlet 用于获取有关一个或多个 Active Directory 组的信息。可以通过多种方式来标识组，例如使用其可分辨名称、组的 GUID、组的 SID 或 SAM 帐户名称。在涉及检索多个 Active Directory 组的方案中，使用 Filter 或 LDAPFilter。过滤条件使用的查询是使用PowerShell表达式语言编写的，支持不同类型的类型转换。这

PowerShell Get-ADGroup 的语法

下面给出了 Get-ADGroup cmdlet 的语法：

Get-ADGroup  [-AuthType <ADAuthType>]   [-Credential <PSCredential>]   -Filter <String>   [-Properties <String[]>]   [-ResultPageSize <Int32>]   [-ResultSetSize <Int32>]   [-SearchBase <String>]   [-SearchScope <ADSearchScope>]   [-Server <String>]   [<CommonParameters>]

Get-ADGrou   [-AuthType <ADAuthType>]   [-Credential <PSCredential>]   [-Identity] <ADGroup>   [-Partition <String>]   [-Properties <String[]>]   [-Server <String>]   [<CommonParameters>]

Get-ADGroup   [-AuthType <ADAuthType>]   [-Credential <PSCredential>]   -LDAPFilter <String>   [-Properties <String[]>]   [-ResultPageSize <Int32>]   [-ResultSetSize <Int32>]   [-SearchBase <String>]   [-SearchScope <ADSearchScope>]   [-Server <String>]   [<CommonParameters>]

参数：

1.凭据：这指的是用于运行 cmdlet 的客户帐户。默认情况下，除非从 Active Directory 驱动器运行 cmdlet，否则将考虑当前客户端的资格。在这种情况下，会考虑与驱动器相关的帐户。提供用户名或 PSCredential 作为对参数的尊重。如果指定了用户名，则会提示输入密码。指示的帐户应该具有目录级授权，否则 cmdlet 将显示错误消息。它的类型是 PSCredential。该参数无法确认管道输入，并且也不允许使用通配符。

2. Authtype：这表示用于连接活动目录的验证策略。它可以是两个值之一：negotiate(0) 或 basic(1)，其中 negotiate 是默认身份验证模式。基本身份验证机制需要 SSL 关联才能发挥作用。参数的类型是 ADAuthType。它不承认管道输入；通配符也是不允许的。

3. Identity：这是一个强制性参数。这表示需要获取的 Active Directory 组。唯一的标题、动态注册表中客户端的 GUID、SID 或 SAM 帐户标题可以作为值传递。该参数的类型是ADGroup。它的默认值是 none。该参数确认管道输入，但不允许使用通配符。

唯一名称示例：

CN=测试、OU=测试、CN=用户、DC=公司、DC=测试、DC=com

GUID 示例：

050c3d2e-f73e-4f20-8a99-030d92425f20

4.过滤器：这表示用于从 Active Directory 中获取对象的查询。它遵循PowerShell Express方言的句子结构。 PowerShell Express 方言具有出色的类型转换功能。它的排序是一个字符串，默认值是无。该参数不确认管道输入，并且也不支持通配符。

示例：

Get-ADGroup -Filter“GroupCategory -eq'Distribution'”

Get-ADGroup -Filter“GroupScope -eq‘通用’”

5. LDAPFilter：这是指用于过滤目的的 LDAP 条件。就像LDAP语法的过滤器一样。该参数的数据类型是字符串。该参数不确认管道输入，并且也不支持通配符。

6.分区：这暗指 Active Directory 块。它必须是当前注册服务器之一的标题。该分区旨在区分字符参数所暗示的问题。如果未指定任何值，则使用默认值。如果传递给身份参数的评价可能是可识别的标题，则自然地由此创建默认评价并将其视为分区标题。如果 cmdlet 是从动态目录提供者运行的，则驱动器中的当前路径将被视为段的默认值。该参数的信息类型是字符串，默认值是无。该参数不承认管道输入和通配符。

7.属性：这表示要返回的 Active Directory 抗议的属性列表。要恢复不同的属性，请使用逗号将它们分开。要恢复所有属性，请使用 *.该参数的信息类型为string[]。默认尊重是无。该参数不承认管道输入和通配符。

8. ResultPageSize： 这表示查询的单个页面上要显示的对象数量。它的排序是int32。默认值为 256。此参数不承认管道输入和通配符。

9. ResultSetSize：这表明查询应该返回的对象的最大数量。如果要返回所有属性，则必须将空值传递给此参数。其信息类型为int32。该参数不承认管道输入和通配符。

10. -SearchBase：这表示必须在其下进行对象搜索的路径。如果 cmdlet 从动态目录驱动器运行，则驱动器的当前路径将被视为默认值。如果 cmdlet 从外部运行，则目标驱动器将被视为默认值。信息类型是字符串，默认值是无。该参数不承认管道输入和通配符。

11. SearchScope：这表明搜索对象的翻查范围。它可以接受三个值：Base 或 0、一级或 1、子树或 2。Base 范围仅搜索指定的客户端。一层搜索抗议的子树，子树查找上述问题的所有子树。

12.服务器：这表示要连接的动态注册表。空间值可以是 FQDN 或 netbios 标题。默认值可以是运行 cmdlet 的空间、Active Directory 驱动器服务器或传递给参数的空间。

PowerShell Get-ADGroup 示例

下面给出的是 PowerShell Get-ADGroup 的示例：

代码：

Write-Host "Welcome to the Get AD group example"
write-host "Fetching the user details based on identity"
Get-ADGroup -Identity o365
Write-Host "Fetching the group details using sid"
Get-ADGroup -Identity 'S-0-5-22-644'
write-host "Example of filtering the group"
Get-ADGroup -Filter "GroupScope -eq 'DomainLocal'"

输出：

结论

这样，本文就PowerShell中的Get-ADGroup cmdlet进行了详细的说明。它保护了与通道相关的 cmdlet 参数。为了更详细地记住，编写测试脚本并磨练它们是合适的。