Zuweisen von KonfigurationsbasislinienHow to Assign Configuration Baselines

In Configuration Manager wird eine Zuweisungs Instanz erstellt, mit einem minimalen Satz von erforderlichen Werten aufgefüllt und gespeichert, um einer Sammlung eine Konfigurations Basislinie zuzuweisen.In Configuration Manager, to assign a configuration baseline to a collection, an assignment instance is created, populated with a minimum set of required values, and saved.

So weisen Sie Konfigurations Basis Linien zuTo assign Configuration Baselines

  1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein.Set up a connection to the SMS Provider.

  2. Erstellen Sie eine Instanz von SMS_BaselineAssignment:Create an instance of SMS_BaselineAssignment.

  3. Füllt die Instanzeigenschaften auf.Populate the instance properties.

  4. Speichern Sie die neue- SMS_BaselineAssignment Instanz.Save the new SMS_BaselineAssignment instance.

BeispielExample

In den folgenden Codebeispielen wird veranschaulicht, wie eine Instanz einer Basis Linien Zuweisung erstellt wird.The following code examples show how to create an instance of a baseline assignment.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration Manager-Codeausschnitten.For information about calling the sample code, see Calling Configuration Manager Code Snippets.


Sub DCMCreateAssignment(swbemServices,                     _  
                        baselineID,                        _  
                        applyToSubTargets,                 _  
                        assignmentAction,                  _  
                        assignmentName,                    _  
                        assignmentDescription,             _  
                        desiredConfigType,                 _  
                        distributionPointLocality,         _  
                        evaluationSchedule,                _  
                        logComplianceToWinEvent,           _  
                        notifyUser,                        _  
                        sendDetailedNonComplianceStatus,   _  
                        startTime,                         _  
                        suppressReboot,                    _  
                        targetCollectionID,                _  
                        useGMTTimes)  

' Create new assignment object.  
set newAssignment = swbemServices.Get("SMS_BaselineAssignment").SpawnInstance_()        

' Assign variable values to assignment properties.  
'    //  
'    // The following properties are set by the provider on put():  
'    //     AssignmentID  
'    //     AssignmentUniqueID  
'    //     SourceSite  
'    //     CreationTime  

newAssignment.ApplyToSubTargets = applyToSubTargets   
newAssignment.AssignmentAction = assignmentAction   
newAssignment.AssignmentName = assignmentName   
newAssignment.AssignmentDescription = assignmentDescription   
newAssignment.DesiredConfigType = desiredConfigType   
newAssignment.DPLocality = distributionPointLocality   
newAssignment.EvaluationSchedule = evaluationSchedule   
newAssignment.LogComplianceToWinEvent = logComplianceToWinEvent   
newAssignment.NotifyUser = notifyUser   
newAssignment.SendDetailedNonComplianceStatus = sendDetailedNonComplianceStatus   
newAssignment.StartTime = startTime   
newAssignment.SuppressReboot = suppressReboot   
newAssignment.TargetCollectionID = targetCollectionID   
newAssignment.UseGMTTimes = useGMTTimes   
newAssignment.AssignedCIs = Array(baselineID)   

' Save assignment.  
newAssignment.Put_  

Wscript.Echo " "  
Wscript.Echo "Created new assignment."      

End Sub  


public void DCMCreateAssignment(WqlConnectionManager connection,  
                                bool applyToSubTargets,  
                                int assignmentAction,  
                                string assignmentName,  
                                string assignmentDescription,  
                                string desiredConfigType,  
                                int distributionPointLocality,  
                                string evaluationSchedule,  
                                bool logComplianceToWinEvent,  
                                bool notifyUser,  
                                bool sendDetailedNonComplianceStatus,  
                                string startTime,  
                                int suppressReboot,  
                                string targetCollectionID,  
                                bool useGMTTimes,  
                                int baselineID)  
{  

    // Set required variables.   
    // Set AssignedCIs like array with a known baseline id (this is the initial creation of the assignment, so no existing values).  
    int[] arrayBaselineNumbers = new int[] { baselineID };  

    try  
    {  
        // Create new assignment object.  
        IResultObject newAssignment = connection.CreateInstance("SMS_BaselineAssignment");  

        // Assign variable values to assignment properties.  
        //  
        // The following properties are set by the provider on put():  
        //     AssignmentID  
        //     AssignmentUniqueID  
        //     SourceSite  
        //     CreationTime  
        newAssignment["ApplyToSubTargets"].BooleanValue = applyToSubTargets;  
        newAssignment["AssignmentAction"].IntegerValue = assignmentAction;  
        newAssignment["AssignmentName"].StringValue = assignmentName;  
        newAssignment["AssignmentDescription"].StringValue = assignmentDescription;  
        newAssignment["DesiredConfigType"].StringValue = desiredConfigType;  
        newAssignment["DPLocality"].IntegerValue = distributionPointLocality;  
        newAssignment["EvaluationSchedule"].StringValue = evaluationSchedule;  
        newAssignment["LogComplianceToWinEvent"].BooleanValue = logComplianceToWinEvent;  
        newAssignment["NotifyUser"].BooleanValue = notifyUser;  
        newAssignment["SendDetailedNonComplianceStatus"].BooleanValue = sendDetailedNonComplianceStatus;  
        newAssignment["StartTime"].StringValue = startTime;  
        newAssignment["SuppressReboot"].IntegerValue = suppressReboot;  
        newAssignment["TargetCollectionID"].StringValue = targetCollectionID;  
        newAssignment["AssignedCIs"].IntegerArrayValue = arrayBaselineNumbers;  
        newAssignment["UseGMTTimes"].BooleanValue = useGMTTimes;  

        // Save assignment object.  
        newAssignment.Put();  
    }  
    catch (SmsException ex)  
    {  
        Console.WriteLine("Failed to create new assignment." + "\\n" + ex.Message);  
        throw;  
    }  

    Console.WriteLine("Created new assignment.");  

}  

Die Beispielmethode verfügt über die folgenden Parameter:The example method has the following parameters:

ParameterParameter typeType BESCHREIBUNGDescription
- connection
- swbemServices
- Verwaltet: WqlConnectionManager- Managed: WqlConnectionManager
- VBScript: SWbemServices- VBScript: SWbemServices
Eine gültige Verbindung mit dem SMS-Anbieter.A valid connection to the SMS Provider.
applyToSubTargets - Verwaltet: Boolean- Managed: Boolean
- VBScript: Boolean- VBScript: Boolean
true , wenn die Konfigurationselement Zuweisung auf eine untergeordnete Sammlung angewendet werden soll.true to apply the configuration item assignment to a subcollection.
assignmentAction - Verwaltet: Integer- Managed: Integer
- VBScript: Integer- VBScript: Integer
Aktion, die der Konfigurationselement Zuweisung zugeordnet ist.Action associated with the configuration item assignment.
assignmentName - Verwaltet: String- Managed: String
- VBScript: String- VBScript: String
Name der ZuordnungassignmentName
assignmentDescription - Verwaltet: String- Managed: String
- VBScript: String- VBScript: String
Der Name der lokalen Zuweisung.The local assignment name.
desiredConfigType - Verwaltet: String- Managed: String
- VBScript: String- VBScript: String
Der Typ des Konfigurations Elements.The type of the configuration item.
distributionPointLocality - Verwaltet: Integer- Managed: Integer
- VBScript: Integer- VBScript: Integer
Flags, die bestimmen, wie der Client Verteilungs Punkte erhält, entsprechend der Verteilungs Punkt Lokalität.Flags that determine how the client obtains distribution points, according to distribution point locality.
evaluationSchedule - Verwaltet: String- Managed: String
- VBScript: String- VBScript: String
Der Zeitplan für die Zuweisung der Zuweisung.The assignment evaluation schedule.
logComplianceToWinEvent - Verwaltet: Boolean- Managed: Boolean
- VBScript: Boolean- VBScript: Boolean
true , um den Konformitäts Status in Windows-Ereignisprotokollen zu protokollieren.true to log compliance status to Windows event logs.
notifyUser - Verwaltet: Boolean- Managed: Boolean
- VBScript: Boolean- VBScript: Boolean
true , um den Benutzer zu benachrichtigen, wenn ein Konfigurationselement verfügbar ist.true to notify the user when a configuration item is available.
sendDetailedNonComplianceStatus - Verwaltet: Boolean- Managed: Boolean
- VBScript: Boolean- VBScript: Boolean
true zum Senden einer detaillierten nicht Kompatibilitäts Statusmeldung.true to send a detailed non-compliance status message.
startTime - Verwaltet: String- Managed: String
- VBScript: String- VBScript: String
Das Datum und die Uhrzeit der anfänglichen Bereitstellung der Konfigurationselement Zuweisung.The date and time when the configuration item assignment was initially offered.
suppressReboot - Verwaltet: Integer- Managed: Integer
- VBScript: Integer- VBScript: Integer
Ein Wert, der angibt, ob der Client den Computer nicht neu starten soll, wenn ein Neustart aussteht, nachdem das Konfigurationselement angewendet wurde.Value indicating whether the client should not reboot the computer, if there is a reboot pending after the configuration item is applied.
targetCollectionID - Verwaltet: String- Managed: String
- VBScript: String- VBScript: String
Der Bezeichner der Auflistung, an die die Zuweisung gerichtet ist.The identifier of the collection to which the assignment is targeted.
useGMTTimes - Verwaltet: Boolean- Managed: Boolean
- VBScript: Boolean- VBScript: Boolean
true , wenn die Zeiten und Zeitpläne in der UTC-Zeit (Universal koordinierte Time) liegen.true if the times and schedules are in Universal Coordinated Time (UTC).
baselineID -Verwaltet: Integer Array- Managed: Integer Array
-VBScript: Integer Array- VBScript: Integer Array
Ein Array von IDs für die Konfigurationselemente, die Ziel der Zuweisung sind.Array of IDs for the configuration items targeted by the assignment.

Kompilieren des CodesCompiling the Code

NamespacesNamespaces

SystemSystem

System.Collections.GenericSystem.Collections.Generic

System.ComponentModelSystem.ComponentModel

Microsoft.ConfigurationManagement.ManagementProviderMicrosoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngineMicrosoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

AssemblyAssembly

adminui.wqlqueryengineadminui.wqlqueryengine

microsoft.configurationmanagement.managementprovidermicrosoft.configurationmanagement.managementprovider

Stabile ProgrammierungRobust Programming

Weitere Informationen zur Fehlerbehandlung finden Sie unter Informationen zu Configuration Manager-Fehlern.For more information about error handling, see About Configuration Manager Errors.

.NET Framework-Sicherheit.NET Framework Security

Weitere Informationen zum Sichern von Configuration Manager Anwendungen finden Sie unter Configuration Manager rollenbasierte Verwaltung.For more information about securing Configuration Manager applications, see Configuration Manager role-based administration.

Weitere InformationenSee Also

Informationen zu konfigurationsbaselines und Konfigurationselementen About Configuration Baselines and Configuration Items
Übersicht über Objekte Vorgehens Weise beim Herstellen einer Verbindung mit einem Configuration Manager Anbieter mithilfe von verwaltetem Code Objects overview How to Connect to a Configuration Manager Provider using Managed Code
Vorgehensweise beim Herstellen einer Verbindung mit einem Configuration Manager-Anbieter mithilfe von WMI How to Connect to a Configuration Manager Provider Using WMI
WMI-Klasse für den SMS_BaselineAssignment ServerSMS_BaselineAssignment Server WMI Class