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