Como Atribuir Linhas de Base de Configuração

Artigo
08/12/2021

No Gestor de Configuração, para atribuir uma linha de base de configuração a uma coleção, é criada uma instância de atribuição, povoada com um conjunto mínimo de valores exigidos e guardada.

Para atribuir linhas de base de configuração

Configurar uma ligação com o Fornecedor DE SMS.
Crie uma instância de SMS_BaselineAssignment.
Povoar as propriedades do caso.
Poupe o novo SMS_BaselineAssignment exemplo.

Exemplo

Os seguintes exemplos de código mostram como criar uma instância de uma atribuição de base.

Para obter informações sobre a chamada do código de amostra, consulte o Código de Identificação do Gestor de Chamadas.


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.");  

}

O método exemplo tem os seguintes parâmetros:

Parâmetro	Tipo	Description
- `connection` - `swbemServices`	- Gerido: `WqlConnectionManager` - VBScript: SWbemServices	Uma ligação válida ao Fornecedor de SMS.
`applyToSubTargets`	- Gerido: `Boolean` - VBScript: `Boolean`	`true` para aplicar a atribuição do item de configuração a uma subcolecção.
`assignmentAction`	- Gerido: `Integer` - VBScript: `Integer`	Ação associada à atribuição de item de configuração.
`assignmentName`	- Gerido: `String` - VBScript: `String`	designName
`assignmentDescription`	- Gerido: `String` - VBScript: `String`	O nome da atribuição local.
`desiredConfigType`	- Gerido: `String` - VBScript: `String`	O tipo de item de configuração.
`distributionPointLocality`	- Gerido: `Integer` - VBScript: `Integer`	Bandeiras que determinam como o cliente obtém pontos de distribuição, de acordo com a localidade do ponto de distribuição.
`evaluationSchedule`	- Gerido: `String` - VBScript: `String`	O horário de avaliação da atribuição.
`logComplianceToWinEvent`	- Gerido: `Boolean` - VBScript: `Boolean`	`true`para registar o estado de conformidade para Windows registos de eventos.
`notifyUser`	- Gerido: `Boolean` - VBScript: `Boolean`	`true` para notificar o utilizador quando um item de configuração estiver disponível.
`sendDetailedNonComplianceStatus`	- Gerido: `Boolean` - VBScript: `Boolean`	`true` para enviar uma mensagem detalhada de incumprimento.
`startTime`	- Gerido: `String` - VBScript: `String`	A data e a hora em que a atribuição do item de configuração foi inicialmente oferecida.
`suppressReboot`	- Gerido: `Integer` - VBScript: `Integer`	Valor indicando se o cliente não deve reiniciar o computador, se houver um reboot pendente após a aplicação do item de configuração.
`targetCollectionID`	- Gerido: `String` - VBScript: `String`	O identificador da coleção a que a atribuição é dirigida.
`useGMTTimes`	- Gerido: `Boolean` - VBScript: `Boolean`	`true` se os horários e horários estiverem em Tempo Coordenado Universal (UTC).
`baselineID`	- Gerido: `Integer` Matriz - VBScript: `Integer` Matriz	Matriz de IDs para os itens de configuração visados pela atribuição.

A Compilar o Código

Espaços de nomes

Sistema

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assemblagem

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Programação Robusta

Para obter mais informações sobre o tratamento de erros, consulte Sobre erros do Gestor de Configuração.

Segurança do .NET Framework

Para obter mais informações sobre a segurança das aplicações do Gestor de Configuração, consulte a administração baseada em funções do Gestor de Configuração.

Consulte também

Sobre linhas de base de configuração e itens de configuração
Visão geral de objetos Como Ligação a um Fornecedor de Gestor de Configuração usando Código Gerido
Como Ligação a um fornecedor de gestor de configuração usando o WMI
Classe WMI do servidor de SMS_BaselineAssignment

Partilhar via