다음을 통해 공유


Update-AzNetworkCloudCluster

제공된 클러스터의 속성을 패치하거나 클러스터와 연결된 태그를 업데이트합니다. 속성 및 태그 업데이트는 독립적으로 수행할 수 있습니다.

구문

Update-AzNetworkCloudCluster
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-AggregatorOrSingleRackDefinitionAvailabilityZone <String>]
      [-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration <IBareMetalMachineConfigurationData[]>]
      [-AggregatorOrSingleRackDefinitionNetworkRackId <String>]
      [-AggregatorOrSingleRackDefinitionRackLocation <String>]
      [-AggregatorOrSingleRackDefinitionRackSerialNumber <String>]
      [-AggregatorOrSingleRackDefinitionRackSkuId <String>]
      [-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration <IStorageApplianceConfigurationData[]>]
      [-AssociatedIdentityType <ManagedServiceIdentitySelectorType>]
      [-AssociatedIdentityUserAssignedIdentityResourceId <String>]
      [-ClusterLocation <String>]
      [-ClusterServicePrincipalApplicationId <String>]
      [-ClusterServicePrincipalId <String>]
      [-ClusterServicePrincipalPassword <SecureString>]
      [-ClusterServicePrincipalTenantId <String>]
      [-CommandOutputSettingContainerUrl <String>]
      [-ComputeDeploymentThresholdGrouping <ValidationThresholdGrouping>]
      [-ComputeDeploymentThresholdType <ValidationThresholdType>]
      [-ComputeDeploymentThresholdValue <Int64>]
      [-ComputeRackDefinition <IRackDefinition[]>]
      [-IdentityType <ManagedServiceIdentityType>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-RuntimeProtectionConfigurationEnforcementLevel <RuntimeProtectionEnforcementLevel>]
      [-SecretArchiveKeyVaultId <String>]
      [-SecretArchiveUseKeyVault <ClusterSecretArchiveEnabled>]
      [-Tag <Hashtable>]
      [-UpdateStrategyMaxUnavailable <Int64>]
      [-UpdateStrategyThresholdType <ValidationThresholdType>]
      [-UpdateStrategyThresholdValue <Int64>]
      [-UpdateStrategyType <ClusterUpdateStrategyType>]
      [-UpdateStrategyWaitTimeMinute <Int64>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzNetworkCloudCluster
      -InputObject <INetworkCloudIdentity>
      [-AggregatorOrSingleRackDefinitionAvailabilityZone <String>]
      [-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration <IBareMetalMachineConfigurationData[]>]
      [-AggregatorOrSingleRackDefinitionNetworkRackId <String>]
      [-AggregatorOrSingleRackDefinitionRackLocation <String>]
      [-AggregatorOrSingleRackDefinitionRackSerialNumber <String>]
      [-AggregatorOrSingleRackDefinitionRackSkuId <String>]
      [-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration <IStorageApplianceConfigurationData[]>]
      [-AssociatedIdentityType <ManagedServiceIdentitySelectorType>]
      [-AssociatedIdentityUserAssignedIdentityResourceId <String>]
      [-ClusterLocation <String>]
      [-ClusterServicePrincipalApplicationId <String>]
      [-ClusterServicePrincipalId <String>]
      [-ClusterServicePrincipalPassword <SecureString>]
      [-ClusterServicePrincipalTenantId <String>]
      [-CommandOutputSettingContainerUrl <String>]
      [-ComputeDeploymentThresholdGrouping <ValidationThresholdGrouping>]
      [-ComputeDeploymentThresholdType <ValidationThresholdType>]
      [-ComputeDeploymentThresholdValue <Int64>]
      [-ComputeRackDefinition <IRackDefinition[]>]
      [-IdentityType <ManagedServiceIdentityType>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-RuntimeProtectionConfigurationEnforcementLevel <RuntimeProtectionEnforcementLevel>]
      [-SecretArchiveKeyVaultId <String>]
      [-SecretArchiveUseKeyVault <ClusterSecretArchiveEnabled>]
      [-Tag <Hashtable>]
      [-UpdateStrategyMaxUnavailable <Int64>]
      [-UpdateStrategyThresholdType <ValidationThresholdType>]
      [-UpdateStrategyThresholdValue <Int64>]
      [-UpdateStrategyType <ClusterUpdateStrategyType>]
      [-UpdateStrategyWaitTimeMinute <Int64>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

제공된 클러스터의 속성을 패치하거나 클러스터와 연결된 태그를 업데이트합니다. 속성 및 태그 업데이트는 독립적으로 수행할 수 있습니다.

예제

예제 1: 클러스터 업데이트

$storageapplianceconfigurationdata = @()
$baremetalmachineconfigurationdata = @()
$computerackdefinition = @(@{IRackDefinition = "The list of rack definitions for the compute racks in a multi-rackcluster, or an empty list in a single-rack cluster."})
$tagHash = @{
    tag = "tag"
    tagUpdate = "tagUpdate"
}
$securePassword = ConvertTo-SecureString "password" -asplaintext -force

Update-AzNetworkCloudCluster -ResourceGroupName resourceGroup -Name clusterName -SubscriptionId subscriptionId -AggregatorOrSingleRackDefinitionNetworkRackId rackId -AggregatorOrSingleRackDefinitionRackSerialNumber sr1234 -AggregatorOrSingleRackDefinitionRackSkuId rackSku -AggregatorOrSingleRackDefinitionAvailabilityZone availabilityzone -AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration $baremetalmachineconfigurationdata -AggregatorOrSingleRackDefinitionRackLocation rackLocation -AggregatorOrSingleRackDefinitionStorageApplianceConfiguration $storageapplianceconfigurationdata -ClusterServicePrincipalApplicationId clusterServicePrincipalAppId -ClusterServicePrincipalId ClusterServicePrincipalId -ClusterServicePrincipalPassword $securePassword -ClusterServicePrincipalTenantId tenantId -ComputeRackDefinition $computerackdefinition -Tag $tagHash

Location Name             SystemDataCreatedAt SystemDataCreatedBy       SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataLastModifiedByType ResourceGro
                                                                                                                                                                                           upName
-------- ----             ------------------- -------------------       ----------------------- ------------------------ ------------------------             ---------------------------- -----------
eastus   clusterName        08/09/2023 18:33:54   user                          User             08/09/2023 19:45:35           user                                       User              RGName

제공된 클러스터의 속성을 패치하거나 클러스터와 연결된 태그를 업데이트합니다. 속성 및 태그 업데이트는 독립적으로 수행할 수 있습니다.

매개 변수

-AggregatorOrSingleRackDefinitionAvailabilityZone

만들 때 이 랙에 사용되는 영역 이름입니다. 가용성 영역은 워크로드 배치에 사용됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AggregatorOrSingleRackDefinitionBareMetalMachineConfiguration

운영 체제 미설치 컴퓨터 구성의 순서가 지정되지 않은 목록입니다. 생성하려면 AGGREGATORORSINGLERACKDEFINITIONBAREMETALMACHINECONFIGURATION 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:IBareMetalMachineConfigurationData[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AggregatorOrSingleRackDefinitionNetworkRackId

이 랙 정의와 일치하는 네트워크 랙의 리소스 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AggregatorOrSingleRackDefinitionRackLocation

랙의 위치에 대한 자유 형식 설명입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AggregatorOrSingleRackDefinitionRackSerialNumber

네트워크 클라우드 클러스터 내의 랙에 대한 고유 식별자입니다. 원하는 경우 일련 번호 이외의 다른 고유 영숫자 값을 제공할 수 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AggregatorOrSingleRackDefinitionRackSkuId

추가되는 랙에 대한 sku의 리소스 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AggregatorOrSingleRackDefinitionStorageApplianceConfiguration

이 랙에 대한 스토리지 어플라이언스 구성 데이터의 목록입니다. 생성하려면 AGGREGATORORSINGLERACKDEFINITIONSTORAGEAPPLIANCECONFIGURATION 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:IStorageApplianceConfigurationData[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AsJob

작업으로 명령 실행

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AssociatedIdentityType

선택 중인 관리 ID의 형식입니다.

형식:ManagedServiceIdentitySelectorType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AssociatedIdentityUserAssignedIdentityResourceId

사용자가 사용할 관리 ID 리소스 ID를 할당했습니다. 시스템 할당 ID 형식과 상호 배타적입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClusterLocation

클러스터가 있는 위치를 식별하기 위해 고객이 제공한 위치 정보입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClusterServicePrincipalApplicationId

서비스 주체의 애플리케이션 ID(클라이언트 ID라고도 함)입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClusterServicePrincipalId

서비스 주체의 개체 ID라고도 하는 보안 주체 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClusterServicePrincipalPassword

서비스 주체의 암호입니다.

형식:SecureString
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ClusterServicePrincipalTenantId

서비스 주체가 만들어지는 테넌트 ID(디렉터리 ID라고도 함)입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CommandOutputSettingContainerUrl

지정된 ID에서 사용할 스토리지 계정 컨테이너의 URL입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ComputeDeploymentThresholdGrouping

클러스터 계산에 형식 평가가 적용되는 방법을 선택합니다.

형식:ValidationThresholdGrouping
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ComputeDeploymentThresholdType

임계값을 평가하는 방법의 선택입니다.

형식:ValidationThresholdType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ComputeDeploymentThresholdValue

숫자 임계값입니다.

형식:Int64
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ComputeRackDefinition

다중 랙 클러스터의 컴퓨팅 랙에 대한 랙 정의 목록 또는 단일 랙 클러스터의 빈 목록입니다. 생성하려면 COMPUTERACKDEFINITION 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:IRackDefinition[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

형식:PSObject
별칭:AzureRMContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IdentityType

관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).

형식:ManagedServiceIdentityType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IdentityUserAssignedIdentity

리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

형식:Hashtable
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

생성할 ID 매개 변수는 INPUTOBJECT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

형식:INetworkCloudIdentity
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

클러스터의 이름입니다.

형식:String
별칭:ClusterName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NoWait

명령을 비동기적으로 실행

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RuntimeProtectionConfigurationEnforcementLevel

런타임 보호를 위한 작업 모드입니다.

형식:RuntimeProtectionEnforcementLevel
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SecretArchiveKeyVaultId

클러스터의 비밀을 보관할 키 자격 증명 모음의 리소스 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SecretArchiveUseKeyVault

지정된 키 자격 증명 모음을 사용하여 클러스터의 비밀을 보관해야 하는지를 나타내는 표시기입니다.

형식:ClusterSecretArchiveEnabled
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SubscriptionId

대상 구독의 ID입니다. 값은 UUID여야 합니다.

형식:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Tag

기존 리소스 태그를 대체할 Azure 리소스 태그입니다.

형식:Hashtable
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UpdateStrategyMaxUnavailable

업데이트 증분 내에서 오프라인일 수 있는 작업자 노드의 최대 수입니다(예: rack-by-rack). 증분에서 최대 컴퓨터 수로 제한됩니다. 기본값은 전체 증분 크기입니다.

형식:Int64
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UpdateStrategyThresholdType

임계값을 평가하는 방법의 선택입니다.

형식:ValidationThresholdType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UpdateStrategyThresholdValue

숫자 임계값입니다.

형식:Int64
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UpdateStrategyType

런타임 보호를 위한 작업 모드입니다.

형식:ClusterUpdateStrategyType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UpdateStrategyWaitTimeMinute

전략에서 정의한 업데이트 증분 사이의 대기 시간입니다.

형식:Int64
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

출력