共用方式為


Get-CMSiteRole

取得網站角色物件。

語法

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

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

類型: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