Get-CMSiteRole

  • 參考
模組:
ConfigurationManager

取得網站角色物件。

Syntax

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

Description

傳回安裝在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

包含此參數以取得月臺的所有角色。

Type:SwitchParameter
Aliases:AllSites
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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

注意事項

此清單可能不包含所有可能的網站角色。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-SiteCode

指定特定月臺角色的月臺碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteSystemServerName

指定要從中取得角色的特定月臺系統伺服器名稱。

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject[]

IResultObject