조건부 작업 Configuration ManagerConfiguration Manager Conditional Actions

지정 된 조건에 따라 Configuration Manager 작업을 표시할 수 있습니다.Configuration Manager actions can be displayed according to specified conditions. 조건은 다음과 같이 정의 됩니다.The conditions are defined by the following:

  • 정규식Regular expressions

  • 메서드 호출Method calls

  • 보안 권한Security permissions

정규식Regular Expressions

정규식을 사용 하 여 문자열 기반 검색 패턴을 적용할 수 있습니다.Regular expressions allow you to apply string-based search patterns. 다음 요소는 동작에 대 한 정규식을 지정 합니다.The following elements specify a regular expression for an action:

요소Element 설명Description
MatchPattern 검색할 패턴을 지정 합니다.Specifies the pattern to search for.
MatchValueToTest 비교할 값을 지정 합니다.Specifies the value to compare against. 다음 값은 ##Sub 선택 된 개체의 속성입니다.The value following ##Sub is a property on the selected object. 속성은 lazy가 아니어야 하며 select 개체에 있어야 합니다.The property must not be lazy and must exist on the select object.

다음 작업은 지정 된 패턴 (MS_ASYNC_RAS)이 선택한 개체의 속성과 일치할 때마다 대화 상자를 표시 합니다 AddressType .The following action displays a dialog box whenever the specified pattern (MS_ASYNC_RAS) matches the selected object's AddressType property:

<ActionDescription ActionVerb="Properties" Class="ShowDialog">  <ShowOn>  <string>DefaultContextualTab</string> <!-- Show on Ribbon -->           <string>ContextMenu</string> <!-- Show on Context Menu -->   </ShowOn>  <MatchPattern>MS_ASYNC_RAS</MatchPattern>  
 <MatchValueToTest>##SUB:AddressType##</MatchValueToTest>  
 <DialogId>AsyncRasSenderAddress</DialogId></ActionDescription>  

메서드 호출Method Calls

메서드 호출의 결과에 따라 동작을 표시할 수 있습니다.An action can be shown depending on the result of a method call. ActionDescription자식 요소는 ActionStateAssembly 호출할 어셈블리, 형식 및 메서드를 정의 합니다.The ActionDescription child element ActionStateAssembly defines the assembly, type, and method to be called. 메서드가를 반환 하는 경우 true 작업이 표시 됩니다. 메서드가 반환 되는 경우 false 작업은 숨겨집니다.If the method returns true, the action is shown; if the method returns false, the action is hidden.

다음 XML은 어셈블리 AdminUI.Addresses.dll에서 라는 메서드를 호출 합니다 EnableDecrementPriorityMenu .The following XML calls a method named EnableDecrementPriorityMenu in the assembly AdminUI.Addresses.dll:

<ActionDescription>  
 <ShowOn>  
    <string>DefaultContextualTab</string> <!-- Show on Ribbon -->         <string>ContextMenu</string><!-- Show on Context Menu --> </ShowOn> <ActionStateAssembly>  
  <Assembly>AdminUI.Addresses.dll</Assembly>   <Type>Microsoft.ConfigurationManagement.AdminConsole.Addresses.AddressUtilityClass</Type>  
  <Method>EnableDecrementPriorityMenu</Method> </ActionStateAssembly>  
</ActionDescription>  

메서드는 다음 서명을 사용 하 여 .NET Framework 어셈블리에서 구현 됩니다.The method is implemented in a .NET Framework assembly with the following signature:

public static bool EnableDecrementPriority(object sender, ScopeNode scopeNode, ActionDescription action, ResultObjectBase resultObject)

.NET Framework 어셈블리에서 메서드를 호출 하는 방법에 대 한 자세한 내용은 AssemblyType 작업 Configuration Manager을 참조 하세요.For more information about calling methods in a .NET Framework assembly, see Configuration Manager AssemblyType Action.

보안 권한Security Permissions

선택 된 개체 또는 개체 클래스에 보안 제한을 적용 하 여 동작의 가용성을 제한할 수 있습니다.You can restrict the availability of an action by applying security restrictions to the selected object or object class.

개체 인스턴스 권한Object Instance Permissions

선택한 개체에 필요한 사용 권한을 적용 하 여 동작의 가용성을 제한할 수 있습니다.You can restrict the availability of an action by applying required permissions to the selected object. 다음 XML 예제에서 다음 요소는 선택 된 개체에 대 한 인스턴스 사용 권한을 지정 합니다.In the following XML example, the following elements specify the instance permissions for the selected object:

요소Element 설명Description
InstancePermissions 인스턴스 권한 목록의 부모 요소입니다.The parent element to the list of instance permissions.
SecurityFlagsDetailDescription 작업을 수행 하기 위해 설정 해야 하는 보안 플래그입니다.The security flags that must be set for the action to work.

다음 XML 예제에서 Delete 선택한 개체에 대 한 작업은 사용자에 게 수정 권한이 있는 경우에만 사용할 수 있습니다.In the following XML example, the Delete action for a selected object is available only if the user has modify permissions:

<ActionDescription ActionVerb="Delete" Class="Default" SelectionMode="Both" InstanceDependsOn="SMS_Site">  
<ShowOn> <string>DefaultContextualTab</string> <!-- Show on Ribbon -->    <string>ContextMenu</string> <!-- Show on Context Menu --></ShowOn><InstancePermissions><SecurityFlagsDetailDescription BitName="Modify" BitValue="2" DependsOn="1" /></InstancePermissions>  
</ActionDescription>  

개체 클래스 권한Object Class Permissions

요소를 사용 하 여 ClassPermissions 작업에 필요한 개체 클래스 권한을 설정할 수 있습니다.You can use the ClassPermissions element to set the object class permissions required for an action. Actionsecuritydescription 개체 클래스와 해당 개체 클래스에 필요한 사용 권한을 설명 합니다.ActionSecurityDescription describes the object class and the required permissions for that object class. 다음 XML 예제에서는 SMS 컬렉션에 필요한 사용 권한을 설명 합니다.The following XML example describes the permissions required for SMS collections:

<ClassPermissions> <ActionSecurityDescription ClassObject="SMS_Collection" RequiredPermissions="1280" />  
</ClassPermissions>  

권한 값Permission Values

Requiredpermissions 특성에 대 한 사용 권한 값은 SecurityFlagsDetailDescription 클래스의 경우와 동일 하며 다음과 같습니다.The permission values for the RequiredPermissions attribute are the same as for the SecurityFlagsDetailDescription class and are as follows:

사용 권한Permission Values 사용Depends on
읽기Read 11 NoneNone
수정Modify 22 11
삭제Delete 44 11
배포Distribute 88 11
CreateChildCreateChild 1616 11
RemoteControlRemoteControl 3232 NoneNone
보급Advertise 6464 11
ModifyResourceModifyResource 128128 11
관리Administer 256256 77
DeleteResourceDeleteResource 512512 11
생성Create 10241024 NoneNone
ViewCollectedFilesViewCollectedFiles 20482048 11
리소스 읽기ReadResource 40964096 11
대리자Delegate 81928192 NoneNone
미터Meter 1638416384 11
ManageSqlCommandManageSqlCommand 3276832768 11
ManageStatusFilterManageStatusFilter 6553665536 11
ManageFolderManageFolder 131072131072 11
NetworkAccessNetworkAccess 262144262144 11
ImportMachineEntryImportMachineEntry 524288524288 11
CreateMediaCertificateCreateMediaCertificate 10485761048576 11
ModifyCollectionSettingModifyCollectionSetting 20971522097152 11
ManageOsdCertificateManageOsdCertificate 41943044194304 11

참고 항목See Also

작업 Configuration Manager Configuration Manager Actions
Configuration Manager Action XML Configuration Manager Action XML
Configuration Manager AssemblyType 작업 Configuration Manager AssemblyType Action
Configuration Manager 실행 가능 작업 Configuration Manager Executable Action
Configuration Manager 그룹 작업 Configuration Manager Group Action
Configuration Manager 보고서 작업 Configuration Manager Report Action
Configuration Manager ShowDialog 작업 Configuration Manager ShowDialog Action
Configuration Manager 작업을 만드는 방법 How to Create a Configuration Manager Action
Configuration Manager 노드 GUID를 찾는 방법How to Find a Configuration Manager Node GUID