Get-CMSiteRole

获取站点角色对象。

语法

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 cmdlet,例如 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
别名:AllSites
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

类型:IResultObject
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-RoleName

指定要获取的特定角色名称。 值是 SMS_SCI_SysResUse 类上 RoleName 属性中的字符串。 例如:

  • 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
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-SiteCode

指定特定站点角色的站点代码。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SiteSystemServerName

指定要从中获取角色的特定站点系统服务器的名称。

类型:String
别名:Name, ServerName
Position:0
默认值:None
必需:False
接受管道输入:False
接受通配符:True

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject[]

IResultObject