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
包含此参数以获取站点的所有角色。
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
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈