Set-DscLocalConfigurationManager

  • Referência
Módulo:
PSDesiredStateConfiguration

Aplica as definições de Configuration Manager Local (LCM) aos nós.

Syntax

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O Set-DscLocalConfigurationManager cmdlet aplica definições de LCM, ou meta-configuração, aos nós. Especifique computadores ao especificar nomes de computador ou ao utilizar sessões do Common Information Model (CIM). Se não especificar um computador de destino, o cmdlet aplica as definições ao computador local.

Exemplos

Exemplo 1: Aplicar definições de LCM

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

Este comando aplica as definições de LCM de C:\DSC\Configurations\ para os nós de destino. Depois de receber as definições, o LCM processa-as.

Aviso

Se existirem vários meta mofs para o mesmo computador armazenado na pasta especificada, apenas o primeiro meta mof será aplicado.

Exemplo 2: Aplicar definições de LCM com uma sessão CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session

Este exemplo aplica definições de LCM a um computador e aplica as definições. O exemplo cria uma sessão CIM para um computador com o nome Server01 para utilização com o cmdlet . Em alternativa, crie uma matriz de sessões CIM para aplicar o cmdlet a vários computadores especificados.

O primeiro comando cria uma sessão CIM com o New-CimSession cmdlet e, em seguida, armazena o objeto CimSession na $Session variável . O comando pede-lhe uma palavra-passe. Para mais informações, insira Get-Help New-CimSession.

O segundo comando aplica as definições de LCM para o nó de destino de C:\DSC\Configurations\ para o computador identificado pelos objetos CimSession armazenados na $Session variável. Neste exemplo, a $Session variável contém uma sessão CIM apenas para o computador com o nome Server01. O comando aplica as definições. Depois de receber as definições, o LCM processa-as.

Parâmetros

-CimSession

Executa o cmdlet numa sessão remota ou num computador remoto. Introduza um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession . A predefinição é a sessão atual no computador local.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica uma matriz de nomes de computadores. Este parâmetro restringe os computadores que têm documentos de meta-configuração no parâmetro Caminho para os especificados na matriz.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Credential

Especifica um nome de utilizador e palavra-passe, como um objeto PSCredential , para o computador de destino. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential. Para mais informações, insira Get-Help Get-Credential.

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

-Force

Força o comando a ser executado sem pedir a confirmação do utilizador.

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

-Path

Especifica um caminho de ficheiro de uma pasta que contém ficheiros de definições de configuração. O cmdlet publica e aplica estas definições de LCM a computadores com ficheiros de definições no caminho especificado. Cada nó de destino tem de ter um ficheiro de definições com o seguinte formato: NetBIOS Name.meta.mof.

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

-ThrottleLimit

Especifica o número máximo de operações simultâneas que podem ser estabelecidas para executar o cmdlet. Se este parâmetro for omitido ou for introduzido um valor de0, Windows PowerShell calcula um limite de limitação ideal para o cmdlet com base no número de cmdlets CIM que estão em execução no computador. O limite de limitação aplica-se apenas ao cmdlet atual, não à sessão ou ao computador.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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