Get-Group
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2010-04-27
Для запроса существующих групп используется командлет Get-Group.
Синтаксис
Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Подробное описание
Командлет Get-Group возвращает все существующие группы, соответствующие указанным параметрам фильтрации, в Microsoft Windows.
Для выполнения командлета Get-Group используемой учетной записи необходимо делегировать следующую роль:
- роль администратора Exchange с правами на просмотр.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Anr |
Необязательный |
System.String |
Параметр Anr указывает, что аргумент будет разрешен при помощи разрешения неоднозначных имен (ANR). |
||
Credential |
Необязательный |
System.Management.Automation.PSCredential |
Параметр Credential указывает учетную запись, используемую для считывания службы каталогов Active Directory. Это особенно полезно при указании глобального каталога. Пароль должен запрашиваться безопасным образом. |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя контроллера домена, который извлекает данные из службы каталогов Active Directory, включите в команду параметр DomainController. |
||
Filter |
Необязательный |
System.String |
Параметр Filter указывает фильтр, который необходимо использовать для фильтрации получателей. Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -Filter. |
||
Identity |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.GroupIdParameter |
Параметр Identity группы рассылки может иметь одну из следующих форм:
|
||
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды параметр, определяющий для командной консоли Exchange область получателя по умолчанию, должен быть проигнорирован, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Active Directory, которые в текущий момент не относятся к области по умолчанию. При использовании параметра IgnoreDefaultScope действуют ограничения, описанные ниже.
|
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Параметр OrganizationalUnit ограничивает результаты контейнером определенного подразделения. |
||
ReadFromDomainController |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ReadFromDomainController указывает на то, что информация о пользователе считывается с контроллера домена в домене пользователя. Если область получателей установлена таким образом, что в нее входят все получатели в лесу, и данный параметр не используется, возможно считывание информации о пользователе из глобального каталога с устаревшими сведениями. Если данный параметр используется, для получения сведений может потребоваться несколько операций чтения.
|
||
RecipientTypeDetails |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Параметр RecipientTypeDetails указывает тип возвращаемых получателей. Типы получателей в Microsoft Exchange Server 2007 разделены на типы и подтипы получателей. Каждый тип получателей содержит все общие свойства всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в Active Directory со связанным почтовым ящиком. Поскольку существует несколько типов почтовых ящиков, каждый тип почтового ящика определяется параметром RecipientTypeDetails. Например, для почтового ящика конференц-зала для параметра RecipientTypeDetails установлено значение ConferenceRoomMailbox, в то время как для почтового ящика пользователя для параметра RecipientTypeDetails установлено значение UserMailbox. Для данной команды доступны следующие сведения о типе получателя.
|
||
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize указывает максимальное количество членов, которые будут возвращены. |
||
SortBy |
Необязательный |
System.String |
Атрибут SortBy используется для сортировки результатов. |
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
Исключения
Исключения | Описание |
---|---|
Пример
Следующий код является примером команды Get-Group. В этом примере команда Get-Group используется без параметров для возвращения всех групп в Active Directory.
Get-Group