Publish-DscConfiguration
Publikuje konfiguraci DSC do sady počítačů.
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
Rutina Publish-DscConfiguration
publikuje dokument konfigurace Windows PowerShell Desired State Configuration (DSC) na sadě počítačů. Tato rutina nepoužije konfiguraci.
Konfigurace se používají rutinou Start-DscConfiguration při použití s parametrem UseExisting nebo při spuštění cyklu konzistence modulu DSC. Modul DSC se označuje také jako místní Configuration Manager (LCM).
Tato rutina je zvlášť užitečná, když se doručují fragmenty více konfiguračních dokumentů. Když je doručeno více fragmentů dokumentů konfigurace, přepíší starší fragmenty konfiguračních dokumentů.
Příklady
Příklad 1: Publikování konfigurace do vzdáleného počítače
Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)
Tento příkaz publikuje konfiguraci do vzdáleného počítače. Uživatel, který spouští rutinu, by měl být na vzdáleném počítači správcem.
Parametry
-CimSession
Spustí rutinu ve vzdálené relaci nebo na vzdáleném počítači. Zadejte název počítače nebo objekt relace, například výstup rutiny New-CimSession nebo Get-CimSession . Výchozí hodnota je aktuální relace v místním počítači.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Určuje jeden nebo více počítačů, na kterých tato rutina publikuje konfiguraci.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Určuje přihlašovací údaje, které se používají pro přístup k cílovému zařízení.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Vynutí dokončení rutiny. Pokud je místní Configuration Manager režimu aktualizace nastavená na PULL, změní se použití tohoto parametru na PUSH a umožní publikování konfigurace DSC. Pokud také existuje čekající konfigurace DSC, použitím tohoto parametru se přepíše čekající konfigurace.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Určuje cestu, která obsahuje konfigurace pro publikování do cílových počítačů.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottleLimit
Určuje maximální počet souběžných operací, které je možné vytvořit pro spuštění rutiny. Pokud je tento parametr vynechán nebo je zadána hodnota 0
, vypočítá Windows PowerShell optimální limit omezení pro rutinu na základě počtu rutin CIM spuštěných v počítači. Omezení se vztahuje pouze na aktuální rutinu, nikoli na relaci nebo na počítač.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |