New-CMBaselineDeployment

  • Artikel

SYNOPSIS

Skapa en baslinjedistribution.

SYNTAX

SearchByValueMandatory (standard)

New-CMBaselineDeployment [-EnableEnforcement <Boolean>] [-GenerateAlert <Boolean>]
 [-InputObject] <IResultObject> [-MonitoredByScom <Boolean>] [-OverrideServiceWindow <Boolean>]
 [-ParameterValue <Int32>] [-PostponeDateTime <DateTime>] [-Schedule <IResultObject>]
 [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

New-CMBaselineDeployment [-EnableEnforcement <Boolean>] [-GenerateAlert <Boolean>] [-Id] <Int32>
 [-MonitoredByScom <Boolean>] [-OverrideServiceWindow <Boolean>] [-ParameterValue <Int32>]
 [-PostponeDateTime <DateTime>] [-Schedule <IResultObject>] [-Collection <IResultObject>]
 [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByNameMandatory

New-CMBaselineDeployment [-EnableEnforcement <Boolean>] [-GenerateAlert <Boolean>] [-MonitoredByScom <Boolean>]
 [-Name] <String> [-OverrideServiceWindow <Boolean>] [-ParameterValue <Int32>] [-PostponeDateTime <DateTime>]
 [-Schedule <IResultObject>] [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Distribuera en konfigurationsbaslinje. Använd cmdleten Get-CMBaseline för att hämta en baslinje.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Distribuera en baslinje till samlingar med samma namngivna prefix

I det här exemplet används Get-CMBaseline för att hämta konfigurationsbaslinjen och lagra den i variabeln $BaselineName. Den använder sedan Get-CMCollection för att hämta en lista över alla samlingar vars namn börjar med "Collection_Name" och lagrar dem i variabeln $DeployToCollections. Därefter skapas ett schema för distributionen med cmdleten New-CMSchedule. När all nödvändig information lagras går exemplet igenom varje samling och distribuerar baslinjen med new-CMBaselineDeployment.

$BaselineName = Get-CMBaseline -Name 'ConfigMgr Baseline'
$DeployToCollections = Get-CMCollection -Name 'Collection_Name*' | Sort-Object -Property "Name"
$BaselineSchedule = New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1

foreach ($Collection in $DeployToCollection)
             {
             New-CMBaselineDeployment -InputObject $BaselineName -CollectionID $Collection.CollectionId -Schedule $BaselineSchedule
             Write-Output "Created Deployment for $($BaselineName.LocalizedDisplayName) on $($Collection.Name)"
             }

Exempel 2: Distribuera en baslinje till en samling

Först skapar det här exemplet ett enkelt schema. Den distribuerar sedan baslinje-MY_Baseline till samlingen med ID:t PS1000023.

$BaselineSchedule = New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1
New-CMBaselineDeployment -Name "MY_Baseline" -CollectionID "PS1000023" -Schedule $BaselineSchedule

PARAMETERS

-Samling

Ange ett samlingsobjekt som mål för baslinjedistributionen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Ange ID för samlingen som mål för distributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Ange namnet på samlingen som mål för distributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableEnforcement

Om $true , reparerar du inkompatibla regler när det stöds.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GenerateAlert

Om $true , genererar du en avisering.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Id

Ange ID för den konfigurationsbaslinje som ska distribueras.

Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID, BaselineId

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

-InputObject

Ange ett konfigurationsbaslinjeobjekt som ska distribueras. Använd cmdleten Get-CMBaseline för att hämta en baslinje.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Baseline

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-MonitoredByScom

Om $true , genererar du en System Center Operations Manager avisering.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Ange namnet på den konfigurationsbaslinje som ska distribueras.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, BaselineName

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

-OverrideServiceWindow

Om $true tillåter du att klienten åtgärdar baslinjen utanför underhållsfönster.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ParameterValue

Om du använder parametern -GenerateAlert anger du ett heltalsvärde i procent (0–100). När kompatibiliteten för den här konfigurationsbaslinjen är lägre än det här värdet genererar platsen en avisering.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PostponeDateTime

Den här parametern motsvarar egenskapen Datum och tid för konfigurationsbaslinjen när du använder parametern -GenerateAlert.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Schema

Ange ett schemaobjekt för när klienten utvärderar den här konfigurationsbaslinjen. Använd cmdleten New-CMSchedule för att skapa ett schema.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMBaseline

Get-CMCollection

New-CMSchedule