New-AzAutomationSoftwareUpdateConfiguration

Modul:

Az.Automation Module

Erstellt eine geplante Azure Automation Software Update-Konfiguration.

Syntax

Windows (Standard)

New-AzAutomationSoftwareUpdateConfiguration
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -Schedule <Schedule>
    [-Windows]
    [-RebootOnly]
    [-AzureVMResourceId <String[]>]
    [-PreTaskRunbookName <String>]
    [-PostTaskRunbookName <String>]
    [-PreTaskRunbookParameter <Hashtable>]
    [-PostTaskRunbookParameter <Hashtable>]
    [-NonAzureComputer <String[]>]
    [-AzureQuery <AzureQueryProperties[]>]
    [-NonAzureQuery <NonAzureQueryProperties[]>]
    [-Duration <TimeSpan>]
    [-RebootSetting <RebootSetting>]
    [-IncludedUpdateClassification <WindowsUpdateClasses[]>]
    [-ExcludedKbNumber <String[]>]
    [-IncludedKbNumber <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Linux

New-AzAutomationSoftwareUpdateConfiguration
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -Schedule <Schedule>
    [-Linux]
    [-RebootOnly]
    [-AzureVMResourceId <String[]>]
    [-PreTaskRunbookName <String>]
    [-PostTaskRunbookName <String>]
    [-PreTaskRunbookParameter <Hashtable>]
    [-PostTaskRunbookParameter <Hashtable>]
    [-NonAzureComputer <String[]>]
    [-AzureQuery <AzureQueryProperties[]>]
    [-NonAzureQuery <NonAzureQueryProperties[]>]
    [-Duration <TimeSpan>]
    [-RebootSetting <RebootSetting>]
    [-IncludedPackageClassification <LinuxPackageClasses[]>]
    [-ExcludedPackageNameMask <String[]>]
    [-IncludedPackageNameMask <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Erstellt eine Softwareupdatekonfiguration, die auf einem Zeitplan ausgeführt wird, um eine Liste von Computern zu aktualisieren. Computer enthalten sowohl virtuelle Azure-Computer als auch Nicht-Az-Computer.

Beispiele

Beispiel 1

Erstellt eine Softwareupdatekonfiguration, um wichtige Updates auf zwei virtuellen Windows Azure-Computern einmal am Samstag um 19:00 Uhr zu installieren. Die Aktualisierungsdauer wird in diesem Beispiel auf 2 Stunden festgelegt.

$startTime = [DateTimeOffset]"2018-09-13T21:00"
$targetMachines = @(
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-01",
    "/subscriptions/22e2445a-0984-4fa5-86a4-0280d76c4b2c/resourceGroups/compute/providers/Microsoft.Compute/virtualMachines/vm-w-02"
)
$duration = New-TimeSpan -Hours 2
$schedule = New-AzAutomationSchedule -ResourceGroupName "mygroup" `
                                                  -AutomationAccountName "myaccount" `
                                                  -Name MyWeeklySchedule `
                                                  -StartTime $startTime `
                                                  -DaysOfWeek Saturday `
                                                  -WeekInterval 1 `
                                                  -ForUpdateConfiguration

New-AzAutomationSoftwareUpdateConfiguration -ResourceGroupName "mygroup" `
                                                 -AutomationAccountName "myaccount" `
                                                 -Schedule $schedule `
                                                 -Windows `
                                                 -AzureVMResourceId $targetMachines `
                                                 -IncludedUpdateClassification Critical `
                                                 -Duration $duration

UpdateConfiguration   : Microsoft.Azure.Commands.Automation.Model.UpdateManagement.UpdateConfiguration
ScheduleConfiguration : Microsoft.Azure.Commands.Automation.Model.Schedule
ProvisioningState     : Provisioning
ErrorInfo             :
ResourceGroupName     : mygroup
AutomationAccountName : myaccount
Name                  : MyWeeklySchedule
CreationTime          : 9/14/2018 3:53:27 AM +00:00
LastModifiedTime      : 9/14/2018 3:53:27 AM +00:00
Description           :

Parameter

-AutomationAccountName

Der Name des Automatisierungskontos.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-AzureQuery

Azure-Abfrage für dynamische Gruppen.

Parametereigenschaften

Typ:	AzureQueryProperties[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-AzureVMResourceId

Ressourcen-IDs für virtuelle Azure-Computer.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	vgl

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:	IAzureContextContainer
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Duration

Maximale Dauer für das Update.

Parametereigenschaften

Typ:	TimeSpan
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-ExcludedKbNumber

KB-Zahlen von ausgeschlossenen Updates.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Windows

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-ExcludedPackageNameMask

Ausgeschlossene Linux-Paketmasken.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Linux

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IncludedKbNumber

KB-Anzahl der enthaltenen Updates.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Windows

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IncludedPackageClassification

Enthaltene Linux-Paketklassifizierungen.

Parametereigenschaften

Typ:	LinuxPackageClasses[]
Standardwert:	None
Zulässige Werte:	Unclassified, Critical, Security, Other
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Linux

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IncludedPackageNameMask

Enthaltene Linux-Paketmasken.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Linux

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IncludedUpdateClassification

Enthaltene Windows Update-Klassifizierungen.

Parametereigenschaften

Typ:	WindowsUpdateClasses[]
Standardwert:	None
Zulässige Werte:	Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Windows

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-Linux

Gibt an, dass die Softwareupdatekonfiguration auf Linux-Betriebssystemcomputer ausgerichtet ist.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Linux

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-NonAzureComputer

Nicht-Az-Computernamen.

Parametereigenschaften

Typ:	String[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-NonAzureQuery

Dynamische Gruppe, die keine Azure-Abfrage ist.

Parametereigenschaften

Typ:	NonAzureQueryProperties[]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-PostTaskRunbookName

Aufgabe posten.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-PostTaskRunbookParameter

Post task parameter.

Parametereigenschaften

Typ:	Hashtable
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-PreTaskRunbookName

Vor der Aufgabe.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-PreTaskRunbookParameter

Parameter "Pre task".

Parametereigenschaften

Typ:	Hashtable
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-RebootOnly

Gibt an, dass die Softwareupdatekonfiguration nur die Computer neu startet.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-RebootSetting

Neustarteinstellung.

Parametereigenschaften

Typ:	RebootSetting
Standardwert:	None
Zulässige Werte:	IfRequired, Never, Always, RebootOnly
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-ResourceGroupName

Der Ressourcengruppenname.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	0
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-Schedule

Schedule-Objekt, das für die Softwareupdatekonfiguration verwendet wird.

Parametereigenschaften

Typ:	Schedule
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Wi

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Windows

Gibt an, dass die Softwareupdatekonfiguration auf Windows-Betriebssystemcomputer ausgerichtet ist.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Windows

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Schedule

SwitchParameter

String

TimeSpan

WindowsUpdateClasses

LinuxPackageClasses

String

Ausgaben

SoftwareUpdateConfiguration