New-AzAutomationSoftwareUpdateConfiguration

スケジュールされた Azure Automation ソフトウェア更新プログラムの構成を作成します。

構文

New-AzAutomationSoftwareUpdateConfiguration
   -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[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzAutomationSoftwareUpdateConfiguration
   -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[]>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

コンピューターの一覧を更新するスケジュールに従って実行されるソフトウェア更新構成を作成します。 コンピューターには、Azure 仮想マシンと az 以外のコンピューターの両方が含まれます。

例 1

毎週土曜日の午後 9 時に 1 回、2 つの Windows Azure 仮想マシンに重要な更新プログラムをインストールするソフトウェア更新構成を作成します。 この例では、更新期間が 2 時間に設定されています。

$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           :

パラメーター

-AutomationAccountName

Automation アカウント名。

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

-AzureQuery

動的グループの Azure クエリ。

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

-AzureVMResourceId

Azure 仮想マシンのリソース ID。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Duration

更新の最大期間。

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

-ExcludedKbNumber

除外された更新プログラムの数をKB (キロバイト)します。

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

-ExcludedPackageNameMask

除外された Linux パッケージ マスク。

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

-IncludedKbNumber

含まれている更新プログラムの数をKB (キロバイト)します。

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

-IncludedPackageClassification

Linux パッケージの分類が含まれています。

Type:LinuxPackageClasses[]
Accepted values:Unclassified, Critical, Security, Other
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IncludedPackageNameMask

Linux パッケージ マスクが含まれています。

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

-IncludedUpdateClassification

Windows Update の分類が含まれています。

Type:WindowsUpdateClasses[]
Accepted values:Unclassified, Critical, Security, UpdateRollup, FeaturePack, ServicePack, Definition, Tools, Updates
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

Linux オペレーティング システム マシンを対象とするソフトウェア更新プログラムの構成を示します。

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

-NonAzureComputer

Az 以外のコンピューター名。

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

-NonAzureQuery

Azure クエリ以外の動的グループ。

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

-PostTaskRunbookName

投稿タスク。

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

-PostTaskRunbookParameter

タスクの事後パラメーター。

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

-PreTaskRunbookName

事前タスク。

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

-PreTaskRunbookParameter

事前タスク パラメーター。

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

-RebootOnly

ソフトウェア更新プログラムの構成がコンピューターのみを再起動することを示します。

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

-RebootSetting

再起動の設定。

Type:RebootSetting
Accepted values:IfRequired, Never, Always, RebootOnly
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

リソース グループ名。

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

-Schedule

ソフトウェア更新プログラムの構成に使用されるオブジェクトをスケジュールします。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

-Windows

Windows オペレーティング システム マシンを対象とするソフトウェア更新プログラムの構成を示します。

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

入力

Schedule

SwitchParameter

String[]

TimeSpan

WindowsUpdateClasses[]

LinuxPackageClasses[]

String

出力

SoftwareUpdateConfiguration