New-CMGlobalCondition

모듈:

ConfigurationManager

Configuration Manager 전역 조건 개체를 만듭니다.

구문

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -DistinguishedName <String>
   -LdapFilter <String>
   [-LdapPrefix <String>]
   -Name <String>
   -Property <String>
   -SearchScope <SearchScope>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-AllInstances]
   -Column <String>
   -Database <String>
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -AssemblyName <String>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -Class <String>
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -Name <String>
   [-Namespace <String>]
   -Property <String>
   [-WhereClause <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -Column <String>
   -Database <String>
   -DataType <GlobalConditionDataType>
   [-DefaultInstance]
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -Column <String>
   -Database <String>
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -InstanceName <String>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   [-MetabasePath <String>]
   -Name <String>
   -PropertyId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   [-Is64Bit <Boolean>]
   -KeyName <String>
   -Name <String>
   -RegistryHive <RegistryRootKey>
   -ValueName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   -Name <String>
   -ScriptLanguage <ScriptingLanguage>
   [-Use32BitHost <Boolean>]
   [-UseLoggedOnUserCredential <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-XmlNamespace <String[]>]
   -XPathQuery <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   -XmlFilePath <String>
   [-XmlNamespace <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   -DataType <GlobalConditionDataType>
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -Name <String>
   -OmaUri <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FileOrFolderName <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   [-IsFolder]
   -Name <String>
   -Path <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   -FilePath <String>
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMGlobalCondition
   [-Description <String>]
   -DeviceType <GlobalConditionDeviceType>
   [-Is64Bit <Boolean>]
   -KeyName <String>
   -Name <String>
   -RegistryHive <RegistryRootKey>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-CMGlobalCondition cmdlet은 Configuration Manager에서 전역 조건을 만듭니다.

전역 조건은 Configuration Manager에서 Configuration Manager에서 애플리케이션을 제공하고 클라이언트에 배포하는 방법을 지정하는 데 사용할 수 있는 설정 또는 식입니다.

참고

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

예제

예제 1: 전역 조건 만들기

PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows

이 명령은 Windows 디바이스에서 Microsoft.Office.Tools.Word.v9.0이라는 어셈블리를 검색하는 전역 조건을 만듭니다.

매개 변수

-AllInstances

전역 조건이 모든 데이터베이스 인스턴스를 검색한다는 것을 나타냅니다. 명명된 인스턴스를 검색하려면 InstanceName 매개 변수를 지정합니다. 기본 인스턴스를 검색하려면 UseDefaultInstance 매개 변수를 지정합니다.

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

-AssemblyName

검색할 어셈블리의 이름을 지정합니다. 어셈블리 이름은 전역 어셈블리 캐시에 등록해야 합니다.

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

-Class

WQL(WMI 쿼리 언어) 쿼리를 빌드하는 데 사용되는 WMI(Windows Management Instrumentation) 클래스를 지정합니다. 쿼리는 클라이언트 컴퓨터의 규정 준수를 평가합니다.

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

-Column

전역 조건의 준수를 평가하는 데 사용되는 열 이름을 지정합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-Database

데이터베이스의 이름을 지정합니다. SQL 쿼리는 이 데이터베이스에서 실행됩니다.

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

-DataType

전역 조건 데이터 형식을 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.

• 부울
• 날짜/시간
• FloatingPoint
• 정수
• IntegerArray
• String
• StringArray
• 버전

형식:	GlobalConditionDataType
허용되는 값:	String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultInstance

전역 조건이 기본 데이터베이스 인스턴스를 검색한다는 것을 나타냅니다. 명명된 인스턴스를 검색하려면 InstanceName 매개 변수를 지정합니다. 모든 인스턴스를 검색하려면 UseAllInstances 매개 변수를 지정합니다.

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

-Description

전역 조건에 대한 설명을 지정합니다.

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

-DeviceType

이 전역 조건이 적용되는 디바이스 유형을 지정합니다. 이 매개 변수에 허용되는 값은 Nokia, Windows 및 WindowsMobile입니다.

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

-DisableWildcardHandling

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

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

-DistinguishedName

클라이언트 컴퓨터에서 준수를 평가할 AD DS(Active Directory Domain Services) 개체의 고유 이름을 지정합니다.

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

-FileOrFolderName

파일 또는 폴더의 이름을 지정합니다. 폴더를 검색할 IsFolder 매개 변수를 지정합니다.

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

-FilePath

조건이 규정 준수를 평가하는 파일의 파일 경로를 지정합니다.

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

-ForceWildcardHandling

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

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

-IncludeSubfolder

cmdlet에 작업에 하위 폴더가 포함되어 있는지 여부를 나타냅니다.

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

-InstanceName

전역 조건이 검색하는 데이터베이스 인스턴스의 이름을 지정합니다. 기본 인스턴스를 검색하려면 UseDefaultInstance 매개 변수를 지정합니다. 모든 인스턴스를 검색하려면 UseAllInstances 매개 변수를 지정합니다.

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

-Is64Bit

전역 조건이 32비트 시스템 파일 위치 외에도 64비트 시스템 파일 위치를 검색한다는 것을 나타냅니다.

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

-IsFolder

전역 조건이 폴더를 검색한다는 것을 나타냅니다. 이 매개 변수를 선택하지 않으면 조건은 파일을 검색합니다. FileOrFolderName 매개 변수를 사용하여 파일 또는 폴더의 이름을 지정합니다.

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

-KeyName

검색할 레지스트리 키 이름을 지정합니다. key\subkey 형식을 사용합니다.

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

-LdapFilter

AD DS 쿼리의 결과를 구체화하여 클라이언트 컴퓨터의 규정 준수를 평가하도록 LDAP(Lightweight Directory Access Protocol) 필터를 지정합니다.

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

-LdapPrefix

클라이언트 컴퓨터의 규정 준수를 평가하는 AD DS 쿼리에 유효한 LDAP 접두사를 지정합니다. 이 접두사는 LDAP:// 또는 GC:// 수 있습니다.

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

-MetabasePath

IIS(인터넷 정보 서비스)에 대한 메타베이스 파일의 경로를 지정합니다.

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

-Name

IIS 메타베이스 파일의 이름을 지정합니다.

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

-Namespace

WMI 리포지토리의 네임스페이스를 지정합니다. 기본값은 Root\cimv2입니다.

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

-OmaUri

OMA(Open Mobile Alliance) 디바이스에 대한 디바이스별 매개 변수를 가리키는 URI(Uniform Resource Indicator)를 지정합니다.

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

-Path

OMA URI의 경로를 지정합니다.

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

-Property

클라이언트 컴퓨터의 규정 준수를 평가하는 데 사용되는 AD DS 개체의 속성을 지정합니다.

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

-PropertyId

Configuration Manager에서 클라이언트 규정 준수를 확인하는 데 사용하는 AD DS의 속성을 지정합니다.

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

-RegistryHive

검색하는 레지스트리 하이브를 식별하는 레지스트리의 루트 키를 지정합니다. WMI는 레지스트리 하이브를 사용하여 레지스트리 키 값을 반환, 설정 및 변경합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.

• ClasssRoot
• CurrentConfig
• CurrentUser
• LocalMachine
• 사용자

형식:	RegistryRootKey
허용되는 값:	ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ScriptLanguage

사용할 스크립팅 언어를 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.

• PowerShell
• VBScript
• JScript

형식:	ScriptingLanguage
허용되는 값:	PowerShell, VBScript, JScript, ShellScript
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SearchScope

AD DS에서 검색 범위를 지정합니다. 이 매개 변수에 허용되는 값은 Base, OneLevel 및 Subtree입니다.

형식:	SearchScope
허용되는 값:	Base, OneLevel, Subtree
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Use32BitHost

파일 또는 폴더가 64비트 애플리케이션과 연결되어 있음을 나타냅니다.

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

-UseLoggedOnUserCredential

로그온한 사용자 자격 증명을 사용할지 여부를 나타냅니다.

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

-ValueName

지정된 레지스트리 키에 포함할 값을 지정합니다.

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

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

-WhereClause

클라이언트 컴퓨터의 지정된 네임스페이스, 클래스 및 속성에 적용할 WQL 쿼리 WHERE 절을 지정합니다.

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

-XmlFilePath

클라이언트 컴퓨터의 규정 준수를 평가하는 데 사용할 XML 쿼리가 포함된 파일을 지정합니다.

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

-XmlNamespace

클라이언트 컴퓨터의 규정 준수를 평가하는 데 사용할 유효한 전체 XPath(XML 경로 언어) 쿼리 배열을 지정합니다.

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

-XPathQuery

XPath 쿼리를 지정합니다.

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

입력

None

출력

IResultObject

관련 링크

• Get-CMGlobalCondition
• Set-CMGlobalCondition
• Remove-CMGlobalCondition