次の方法で共有


Update-AzConnectedMachine

ハイブリッド マシンを更新する操作。

構文

UpdateExpanded (既定)

Update-AzConnectedMachine
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-EnableSystemAssignedIdentity <Boolean>]
    [-AgentUpgradeCorrelationId <String>]
    [-AgentUpgradeDesiredVersion <String>]
    [-AgentUpgradeEnableAutomatic]
    [-IdentityType <String>]
    [-Kind <String>]
    [-LocationDataCity <String>]
    [-LocationDataCountryOrRegion <String>]
    [-LocationDataDistrict <String>]
    [-LocationDataName <String>]
    [-OSProfile <IOSProfile>]
    [-ParentClusterResourceId <String>]
    [-PrivateLinkScopeResourceId <String>]
    [-Tag <Hashtable>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Update

Update-AzConnectedMachine
    -Name <String>
    -ResourceGroupName <String>
    -Parameter <IMachineUpdate>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonFilePath

Update-AzConnectedMachine
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonString

Update-AzConnectedMachine
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentity

Update-AzConnectedMachine
    -InputObject <IConnectedMachineIdentity>
    -Parameter <IMachineUpdate>
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

Update-AzConnectedMachine
    -InputObject <IConnectedMachineIdentity>
    [-EnableSystemAssignedIdentity <Boolean>]
    [-AgentUpgradeCorrelationId <String>]
    [-AgentUpgradeDesiredVersion <String>]
    [-AgentUpgradeEnableAutomatic]
    [-IdentityType <String>]
    [-Kind <String>]
    [-LocationDataCity <String>]
    [-LocationDataCountryOrRegion <String>]
    [-LocationDataDistrict <String>]
    [-LocationDataName <String>]
    [-OSProfile <IOSProfile>]
    [-ParentClusterResourceId <String>]
    [-PrivateLinkScopeResourceId <String>]
    [-Tag <Hashtable>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

ハイブリッド マシンを更新する操作。

例 1: ハイブリッド コンピューターを更新する

Update-AzConnectedMachine -Name $env.MachineName -ResourceGroupName $env.ResourceGroupName -PrivateLinkScopeResourceId $env.PrivateLinkScopeUri
AdFqdn                                      : ********
AgentConfigurationConfigMode                : full
AgentConfigurationExtensionsAllowList       : {}
AgentConfigurationExtensionsBlockList       : {}
AgentConfigurationExtensionsEnabled         : true
AgentConfigurationGuestConfigurationEnabled : true
AgentConfigurationIncomingConnectionsPort   : {}
AgentConfigurationProxyBypass               : {}
AgentConfigurationProxyUrl                  :
AgentUpgradeCorrelationId                   :
AgentUpgradeDesiredVersion                  :
AgentUpgradeEnableAutomaticUpgrade          : False
AgentUpgradeLastAttemptDesiredVersion       :
AgentUpgradeLastAttemptMessage              :
AgentUpgradeLastAttemptStatus               :
AgentUpgradeLastAttemptTimestamp            :
AgentVersion                                : *******
ClientPublicKey                             : ********-****-****-****-**********
CloudMetadataProvider                       : N/A
DetectedProperty                            : {
                                                "cloudprovider": "N/A",
                                                "coreCount": "4",
                                                "logicalCoreCount": "8",
                                                "manufacturer": "LENOVO",
                                                "model": "*******",
                                                "mssqldiscovered": "false",
                                                "processorCount": "1",
                                                "processorNames": "11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz",
                                                "productType": "4",
                                                "serialNumber": "********",
                                                "smbiosAssetTag": "********",
                                                "totalPhysicalMemoryInBytes": "********",
                                                "totalPhysicalMemoryInGigabytes": "32",
                                                "vmuuidEsu2012": "********-****-****-****-**********"
                                              }
DisplayName                                 : ********
DnsFqdn                                     : ********
DomainName                                  : WORKGROUP
ErrorDetail                                 : {}
Extension                                   :
ExtensionServiceStartupType                 : automatic
ExtensionServiceStatus                      : running
Fqdn                                        : ********
GuestConfigurationServiceStartupType        : automatic
GuestConfigurationServiceStatus             : running
Id                                          : /subscriptions/********-****-****-****-**********/resourceGroups/
                                              ********/providers/Microsoft.HybridCompute/machines/********
IdentityPrincipalId                         : ********-****-****-****-**********
IdentityTenantId                            : ********-****-****-****-**********
IdentityType                                : SystemAssigned
Kind                                        :
LastStatusChange                            : 9/20/2024 1:42:35 AM
LicenseProfile                              : {
                                                "esuProfile": {
                                                  "serverType": "Unknown",
                                                  "esuEligibility": "Ineligible",
                                                  "esuKeyState": "Inactive",
                                                  "licenseAssignmentState": "NotAssigned"
                                                },
                                                "licenseStatus": "Licensed",
                                                "licenseChannel": "Retail"
                                              }
Location                                    : centraluseuap
LocationDataCity                            :
LocationDataCountryOrRegion                 :
LocationDataDistrict                        :
LocationDataName                            :
MssqlDiscovered                             : false
Name                                        : testmachine
NetworkProfileNetworkInterface              : {{
                                                "ipAddresses": [
                                                  {
                                                    "subnet": {
                                                      "addressPrefix": "********"
                                                    },
                                                    "address": "********",
                                                    "ipAddressVersion": "IPv4"
                                                  }
                                                ]
                                              }, {
                                                "ipAddresses": [
                                                  {
                                                    "subnet": {
                                                      "addressPrefix": "********"
                                                    },
                                                    "address": "********",
                                                    "ipAddressVersion": "IPv4"
                                                  }
                                                ]
                                              }, {
                                                "ipAddresses": [
                                                  {
                                                    "subnet": {
                                                      "addressPrefix": "********"
                                                    },
                                                    "address": "********",
                                                    "ipAddressVersion": "IPv6"
                                                  }
                                                ]
                                              }}
OSEdition                                   : enterprise
OSName                                      : windows
OSProfile                                   : {
                                                "computerName": "********"
                                              }
OSSku                                       : Windows 10 Enterprise
OSType                                      : windows
OSVersion                                   : ********
ParentClusterResourceId                     :
PrivateLinkScopeResourceId                  :
ProvisioningState                           : Succeeded
Resource                                    :
ResourceGroupName                           : ********
Status                                      : Connected
SystemDataCreatedAt                         :
SystemDataCreatedBy                         :
SystemDataCreatedByType                     :
SystemDataLastModifiedAt                    :
SystemDataLastModifiedBy                    :
SystemDataLastModifiedByType                :
Tags                                        : {
                                              }
Type                                        : Microsoft.HybridCompute/machines
VMId                                        : ********-****-****-****-**********
VMUuid                                      : ********-****-****-****-**********

ハイブリッド マシンを更新する

パラメーター

-AgentUpgradeCorrelationId

アップグレードごとに RSM から渡される関連付け ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AgentUpgradeDesiredVersion

マシンのバージョン情報 w.r.t AgentUpgrade を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AgentUpgradeEnableAutomatic

RSM がこのマシンのアップグレードを試みる必要があるかどうかを指定します

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

パラメーターのプロパティ

型:PSObject
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EnableSystemAssignedIdentity

リソースに対してシステム割り当て ID を有効にするかどうかを決定します。

パラメーターのプロパティ

型:

Nullable<T>[Boolean]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IdentityType

ID の種類。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-InputObject

IDENTITY パラメーター

パラメーターのプロパティ

型:IConnectedMachineIdentity
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateViaIdentity
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JsonFilePath

更新操作に指定された Json ファイルのパス

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateViaJsonFilePath
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JsonString

更新操作に指定された Json 文字列

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateViaJsonString
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Kind

HCI、SCVMM、VMware など、オンプレミスの Arc マシン配置の種類を示します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LocationDataCity

リソースが配置されている都市または地域。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LocationDataCountryOrRegion

リソースが配置されている国またはリージョン

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LocationDataDistrict

リソースが配置されている地区、州、または都道府県。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LocationDataName

地理的または物理的な場所の正規名。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

ハイブリッド マシンの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Machinename

パラメーター セット

UpdateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Update
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaJsonFilePath
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaJsonString
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OSProfile

ハイブリッド コンピューターのオペレーティング システム設定を指定します。

パラメーターのプロパティ

型:IOSProfile
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Parameter

ハイブリッド コンピューターの更新について説明します。

パラメーターのプロパティ

型:IMachineUpdate
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Update
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentity
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ParentClusterResourceId

このマシンが割り当てられている親クラスター (Azure HCI) のリソース ID (存在する場合)。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PrivateLinkScopeResourceId

このマシンが割り当てられているプライベート リンク スコープのリソース ID (存在する場合)。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceGroupName

リソース グループの名前。 名前の大文字と小文字は区別されません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Update
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaJsonFilePath
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaJsonString
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SubscriptionId

ターゲット サブスクリプションの ID。

パラメーターのプロパティ

型:String
規定値:(Get-AzContext).Subscription.Id
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
Update
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaJsonFilePath
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaJsonString
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Tag

リソース タグ

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateViaIdentityExpanded
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

IConnectedMachineIdentity

IMachineUpdate

出力

IMachine