Поделиться через

Get-CMSiteRole

  • Ссылка
Модуль:
ConfigurationManager

Получение объекта роли сайта.

Синтаксис

Get-CMSiteRole
   [-AllSite]
   [-RoleName <String>]
   [-SiteCode <String>]
   [[-SiteSystemServerName] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSiteRole
   [-AllSite]
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Описание

Возвращает роли, установленные на сервере системы сайта Configuration Manager. Например, точка управления или точка распространения.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Получение всех ролей со всех сайтов

В этом примере возвращаются все роли для всех сайтов в иерархии.

Get-CMSiteRole -AllSite

Пример 2. Получение всех ролей для определенного сайта

В этом примере получаются все роли с сайта P01.

Get-CMSiteRole -SiteCode P01

Пример 3. Получение ролей для определенного сервера

В этом примере возвращаются все роли, установленные в системе сайта cm01.contoso.local.

Get-CMSiteRole -SiteSystemServerName "cm01.contoso.local"

Пример 4. Подсчет всех точек управления

В этом примере возвращаются все точки управления в иерархии и отображается счетчик.

$mp = Get-CMSiteRole -RoleName "SMS Management Point" -AllSite
$mp.Count

Пример 5. Перечисление всех ролей по имени

В этом примере перечислены имена ролей для всех сайтов в иерархии.

$allRoles = Get-CMSiteRole -AllSite
$allRoles.RoleName

Параметры

-AllSite

Включите этот параметр, чтобы получить все роли для сайта.

Тип:SwitchParameter
Aliases:AllSites
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-RoleName

Укажите имя определенной роли для получения. Значением является строка из свойства RoleName класса SMS_SCI_SysResUse . Например:

  • SMS Site System
  • SMS Component Server
  • SMS Distribution Point
  • SMS Management Point
  • SMS Device Management Point
  • SMS Software Update Point
  • SMS Enrollment Server
  • SMS Enrollment Web Site
  • SMS Notification Server
  • SMS Certificate Registration Point
  • SMS DM Enrollment Service
  • SMS Site Server
  • SMS State Migration Point
  • SMS Provider
  • SMS Cloud Proxy Connector
  • SMS SQL Server
  • SMS Fallback Status Point
  • AI Update Service Point
  • SMS SRS Reporting Point
  • SMS Endpoint Protection Point
  • Data Warehouse Service Point
  • SMS Dmp Connector

Примечание.

Этот список может содержать не все возможные роли сайта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-SiteCode

Укажите код сайта для конкретной роли сайта.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SiteSystemServerName

Укажите имя определенного сервера системы сайта, с которого будет получена роль.

Тип:String
Aliases:Name, ServerName
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject[]

IResultObject