Publish-DscConfiguration

  • Référence
Module:
PSDesiredStateConfiguration

Publie une configuration DSC sur un ensemble d’ordinateurs.

Syntax

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

Description

L’applet Publish-DscConfiguration de commande publie un document de configuration Windows PowerShell Desired State Configuration (DSC) sur un ensemble d’ordinateurs. Cette applet de commande n’applique pas la configuration. Les configurations sont appliquées par l’applet de commande Start-DscConfiguration lorsqu’elle est utilisée avec le paramètre UseExisting ou lorsque le moteur DSC exécute son cycle de cohérence. Le moteur DSC est également appelé Configuration Manager local (LCM).

Cette applet de commande est particulièrement utile lorsque des fragments de plusieurs documents de configuration sont remis. Lorsque plusieurs fragments de documents de configuration sont remis, ils remplacent les anciens fragments de document de configuration.

Exemples

Exemple 1 : Publier une configuration sur un ordinateur distant

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

Cette commande publie une configuration sur un ordinateur distant. L’utilisateur qui exécute l’applet de commande doit être administrateur sur l’ordinateur distant.

Paramètres

-CimSession

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, tel que la sortie d’une applet de commande New-CimSession ou Get-CimSession . La valeur par défaut est la session active sur l’ordinateur local.

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

-ComputerName

Spécifie un ou plusieurs ordinateurs sur lesquels cette applet de commande publie la configuration.

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Credential

Spécifie les informations d’identification utilisées pour accéder à l’appareil cible.

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

-Force

Force la fin de l’applet de commande. Si le mode d’actualisation Configuration Manager local est défini sur PULL, l’utilisation de ce paramètre le remplace par PUSH et active la publication de la configuration DSC. En outre, s’il existe une configuration DSC en attente, l’utilisation de ce paramètre remplace cette configuration en attente.

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

-Path

Spécifie un chemin d’accès qui contient les configurations à publier sur les ordinateurs cibles.

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

-ThrottleLimit

Spécifie le nombre maximal d’opérations simultanées pouvant être établi pour exécuter l’applet de commande. Si ce paramètre est omis ou qu’une valeur de 0 est entrée, Windows PowerShell calcule une limite de limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM exécutées sur l’ordinateur. Le seuil de limitation s’applique uniquement à l’applet de commande active et non à la session ou à l’ordinateur.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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