다음을 통해 공유


Get-CMConfigurationPlatform

요구 사항 규칙에 대한 OS 플랫폼을 가져옵니다.

구문

Get-CMConfigurationPlatform
   [-Fast]
   [-IsSupported <Boolean>]
   [[-Name] <String>]
   [-PlatformOption <PlatformType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPlatform
   [-Fast]
   [-Id] <Int32>
   [-IsSupported <Boolean>]
   [-PlatformOption <PlatformType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 애플리케이션 배포 유형에 대한 OS 요구 사항 규칙과 함께 사용할 OS 플랫폼을 가져옵니다. New-CMRequirementRuleOperatingSystemValue cmdlet과 함께 이 cmdlet의 출력 개체를 사용할 수 있습니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 플랫폼별 OS에 대한 요구 사항 규칙 추가

이 예제에서는 먼저 Get-CMGlobalCondition cmdlet을 사용하여 비모바일 Windows 디바이스에 대한 기본 운영 체제 전역 조건을 가져옵니다. 그런 다음 Windows Server 2016 및 Windows Server 2019용 두 플랫폼에 대한 변수를 정의합니다. 다음으로 New-CMRequirementRuleOperatingSystemValue cmdlet을 사용하여 이러한 두 플랫폼을 포함하는 요구 사항 규칙 개체를 만듭니다. 마지막으로 해당 규칙 개체를 Set-CMScriptDeploymentType cmdlet에 전달하여 요구 사항을 추가합니다.

$myGC = Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1

$platformA = Get-CMConfigurationPlatform -Name "All Windows Server 2019 and higher (64-bit)"

$platformB = Get-CMConfigurationPlatform -Name "All Windows Server 2016 and higher (64-bit)"

$myRule = $myGC | New-CMRequirementRuleOperatingSystemValue -RuleOperator OneOf -Platform $platformA, $platformB

Set-CMScriptDeploymentType -ApplicationName "Central App" -DeploymentTypeName "Install" -AddRequirement $myRule

매개 변수

-DisableWildcardHandling

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

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

-Fast

지연 속성을 자동으로 새로 고치지 않도록 이 매개 변수를 추가합니다. 지연 속성에는 검색에 상대적으로 비효율적인 값이 포함됩니다. 이러한 속성을 가져오면 추가 네트워크 트래픽이 발생하고 cmdlet 성능이 저하될 수 있습니다.

이 매개 변수를 사용하지 않으면 cmdlet에 경고가 표시됩니다. 이 경고를 사용하지 않도록 설정하려면 를 설정합니다 $CMPSSuppressFastNotUsedCheck = $true.

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

-ForceWildcardHandling

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

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

-Id

플랫폼의 CI_ID 정수 값을 지정합니다. 예를 들어 모든 Windows Server 2019 이상(64비트) 플랫폼에 대한 CI_ID 입니다287650.

다음과 유사한 명령을 사용하여 플랫폼에 대한 CI_ID 검색합니다.

Get-CMConfigurationPlatform -Name "*Server 2019*" | Select-Object LocalizedDisplayName, CI_ID

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

-IsSupported

Configuration Manager는 이전 버전과의 호환성을 위해 레거시 플랫폼을 여전히 정의합니다. 현재 지원되는 플랫폼으로만 결과를 필터링하려면 이 매개 변수 $true 를 로 설정합니다.

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

-Name

OS 플랫폼의 이름을 지정합니다. 와일드카드 문자를 사용할 수 있습니다.

  • *: 여러 문자
  • ?: 단일 문자
형식:String
별칭:LocalizedDisplayName
Position:0
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PlatformOption

이 매개 변수를 사용하여 플랫폼 유형별로 결과를 필터링합니다.

형식:PlatformType
허용되는 값:None, Windows, Mobile, Mac, MixedPlatform
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

출력

IResultObject[]

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_ConfigurationPlatform 서버 WMI 클래스를 참조하세요.

이 cmdlet은 유사한 Get-CMSupportedPlatform cmdlet과 다릅니다.