다음을 통해 공유


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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

형식:IResultObject
Position:Named
Default value: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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-SiteCode

특정 사이트 역할에 대한 사이트 코드를 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SiteSystemServerName

역할을 가져올 특정 사이트 시스템 서버의 이름을 지정합니다.

형식:String
별칭:Name, ServerName
Position:0
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject[]

IResultObject