Share via


Set-CMGlobalCondition

Configuration Manager 전역 조건에 대한 설정을 수정합니다.

Syntax

Set-CMGlobalCondition
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-AssemblyName <String>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Class <String>]
   -Name <String>
   [-Namespace <String>]
   [-PassThru]
   [-Property <String>]
   [-WhereClause <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-UseDefaultInstance]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-UseAllInstances]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Column <String>]
   [-Database <String>]
   [-FilePath <String>]
   [-InstanceName <String>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-DistinguishedName <String>]
   [-LdapFilter <String>]
   [-LdapPrefix <String>]
   -Name <String>
   [-PassThru]
   [-Property <String>]
   [-SearchScope <SearchScope>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FileOrFolderName <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-Path <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FilePath <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FilePath <String>]
   -Name <String>
   [-PassThru]
   [-ScriptLanguage <ScriptingLanguage>]
   [-Use32BitHost <Boolean>]
   [-UseLoggedOnUserCredential <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-FilePath <String>]
   [-IncludeSubfolder <Boolean>]
   [-Is64Bit <Boolean>]
   -Name <String>
   [-PassThru]
   [-XmlFilePath <String>]
   [-XmlNamespace <String[]>]
   [-XPathQuery <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Is64Bit <Boolean>]
   [-KeyName <String>]
   -Name <String>
   [-PassThru]
   [-RegistryHive <RegistryRootKey>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-Is64Bit <Boolean>]
   [-KeyName <String>]
   -Name <String>
   [-PassThru]
   [-RegistryHive <RegistryRootKey>]
   [-ValueName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   [-MetabasePath <String>]
   -Name <String>
   [-PassThru]
   [-PropertyId <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMGlobalCondition
   -Name <String>
   -OmaUri <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-CMGlobalCondition cmdlet은 전역 조건에 대한 설정을 수정합니다. 전역 조건에 대한 보안 범위를 추가하거나 제거할 수 있습니다. 이름 또는 ID로 전역 조건을 지정하거나 Get-CMGlobalCondition cmdlet 을 사용하여 전역 조건 개체를 가져올 수 있습니다.

Configuration Manager 글로벌 조건을 사용하여 비즈니스 또는 기술 조건을 나타냅니다. 전역 조건은 클라이언트 디바이스에 애플리케이션을 제공하고 배포하는 방법을 지정합니다.

각 전역 조건에는 하나 이상의 보안 범위가 있어야 합니다.

참고

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

예제

예제 1: 보안 범위 추가

PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"

이 명령은 Scope22라는 보안 범위를 CPU speed라는 전역 조건에 추가합니다.

예제 2: 변수를 사용하여 보안 범위 제거

PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"

첫 번째 명령은 Get-CMGlobalCondition cmdlet 을 사용하여 CPU speed라는 전역 조건을 가져와서 $CMGC 변수에 저장합니다.

두 번째 명령은 $CMGC 변수에 저장된 전역 조건에서 Scope22라는 보안 범위를 제거합니다.

매개 변수

-AssemblyName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Class

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Column

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Database

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
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

-DistinguishedName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileOrFolderName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

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

Type:String
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

-IncludeSubfolder

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

Type:Boolean
Aliases:IncludeSubfolders
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Is64Bit

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LdapFilter

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LdapPrefix

클라이언트 컴퓨터의 규정 준수를 평가하는 AD DS 쿼리에 유효한 LDAP 접두사를 지정합니다. 이 매개 변수에 허용되는 값은 LDAP:// 또는 GC://.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MetabasePath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

전역 조건의 이름을 지정합니다. 이 값은 전역 조건 개체의 LocalizedDisplayName 속성에 해당합니다.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

전역 조건의 새 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OmaUri

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

현재 작업 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Property

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PropertyId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RegistryHive

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

  • ClasssRoot
  • CurrentConfig
  • CurrentUser
  • LocalMachine
  • 사용자
Type:RegistryRootKey
Accepted values:ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptLanguage

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

  • PowerShell
  • Vbscript
  • Jscript
Type:ScriptingLanguage
Accepted values:PowerShell, VBScript, JScript, ShellScript
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchScope

AD DS에서 검색 범위를 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.

  • 기본
  • OneLevel
  • 하위 트리의
Type:SearchScope
Accepted values:Base, OneLevel, Subtree
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Use32BitHost

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseAllInstances

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseDefaultInstance

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseLoggedOnUserCredential

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

Type:Boolean
Aliases:UseLoggedOnUserCredentials
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValueName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhereClause

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-XmlFilePath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-XmlNamespace

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

Type:String[]
Aliases:XmlNamespaces
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-XPathQuery

XPath 쿼리를 지정합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

System.Object