From a95101f98a7478e99db66955e913dd91af032e83 Mon Sep 17 00:00:00 2001 From: Jinpei Li Date: Wed, 17 Sep 2025 10:41:22 +0800 Subject: [PATCH 1/6] Az.CloudService update generation tool version: autorest.powershell v3->v4 --- .../Properties/AssemblyInfo.cs | 1 + .../CloudService.Autorest/README.md | 249 +++--------------- .../custom/New-AzCloudService.ps1 | 11 +- ...New-AzCloudServiceDiagnosticsExtension.ps1 | 3 +- .../New-AzCloudServiceExtensionObject.ps1 | 68 ----- ...ServiceLoadBalancerConfigurationObject.ps1 | 44 ---- ...dBalancerFrontendIPConfigurationObject.ps1 | 40 +-- ...oudServiceRemoteDesktopExtensionObject.ps1 | 4 +- ...loudServiceRoleProfilePropertiesObject.ps1 | 51 ---- ...w-AzCloudServiceVaultSecretGroupObject.ps1 | 25 +- .../custom/Serialization/CloudService.cs | 25 +- .../custom/Serialization/CloudServiceTags.cs | 15 -- .../CloudServiceVaultCertificate.cs | 15 -- .../ResourceInstanceViewStatus.cs | 15 -- .../custom/Serialization/RoleInstanceTags.cs | 15 -- .../custom/Serialization/StatusCodeCount.cs | 15 -- .../custom/Switch-AzCloudService.ps1 | 38 +-- .../New-AzCloudServiceExtensionObject.ps1 | 112 ++++++++ ...ServiceLoadBalancerConfigurationObject.ps1 | 60 +++++ ...loudServiceRoleProfilePropertiesObject.ps1 | 66 +++++ .../docs/Az.CloudService.md | 18 +- .../docs/Get-AzCloudService.md | 3 +- .../docs/Get-AzCloudServiceInstanceView.md | 2 +- .../Get-AzCloudServiceNetworkInterface.md | 51 +++- .../docs/Get-AzCloudServiceOSFamily.md | 26 +- .../docs/Get-AzCloudServiceOSVersion.md | 26 +- .../docs/Get-AzCloudServicePublicIPAddress.md | 100 ++++++- .../docs/Get-AzCloudServiceRoleInstance.md | 36 ++- ...oudServiceRoleInstanceRemoteDesktopFile.md | 31 ++- .../Get-AzCloudServiceRoleInstanceView.md | 32 ++- .../docs/Invoke-AzCloudServiceRebuild.md | 61 ++++- .../docs/Invoke-AzCloudServiceReimage.md | 9 +- ...nvoke-AzCloudServiceRoleInstanceRebuild.md | 1 - ...nvoke-AzCloudServiceRoleInstanceReimage.md | 1 - .../docs/New-AzCloudService.md | 96 +++++-- .../New-AzCloudServiceDiagnosticsExtension.md | 26 +- .../docs/New-AzCloudServiceExtensionObject.md | 84 +++++- ...dServiceLoadBalancerConfigurationObject.md | 37 ++- ...adBalancerFrontendIPConfigurationObject.md | 46 ++-- ...loudServiceRemoteDesktopExtensionObject.md | 26 +- ...CloudServiceRoleProfilePropertiesObject.md | 14 +- ...ew-AzCloudServiceVaultSecretGroupObject.md | 32 ++- .../docs/Remove-AzCloudService.md | 1 - .../docs/Remove-AzCloudServiceRoleInstance.md | 59 ++++- .../docs/Restart-AzCloudService.md | 61 ++++- .../Restart-AzCloudServiceRoleInstance.md | 24 +- .../docs/Set-AzCloudServiceUpdateDomain.md | 49 +++- .../docs/Start-AzCloudService.md | 1 - .../docs/Stop-AzCloudService.md | 1 - .../docs/Switch-AzCloudService.md | 27 +- .../docs/Update-AzCloudService.md | 12 +- .../New-AzCloudServiceDiagnosticsExtension.md | 23 +- ...adBalancerFrontendIPConfigurationObject.md | 25 +- ...loudServiceRemoteDesktopExtensionObject.md | 23 +- ...ew-AzCloudServiceVaultSecretGroupObject.md | 23 +- .../examples/Switch-AzCloudService.md | 21 +- .../CloudService.Autorest/generate-info.json | 2 +- ...iceRoleInstanceRemoteDesktopFile.Tests.ps1 | 2 +- src/CloudService/CloudService.sln | 28 +- .../CloudService/Az.CloudService.psd1 | 4 +- .../CloudService/help/Az.CloudService.md | 16 +- .../CloudService/help/Get-AzCloudService.md | 3 +- .../help/Get-AzCloudServiceInstanceView.md | 2 +- .../Get-AzCloudServiceNetworkInterface.md | 52 +++- .../help/Get-AzCloudServiceOSFamily.md | 26 +- .../help/Get-AzCloudServiceOSVersion.md | 26 +- .../help/Get-AzCloudServicePublicIPAddress.md | 100 ++++++- .../help/Get-AzCloudServiceRoleInstance.md | 36 ++- ...oudServiceRoleInstanceRemoteDesktopFile.md | 31 ++- .../Get-AzCloudServiceRoleInstanceView.md | 32 ++- .../help/Invoke-AzCloudServiceRebuild.md | 59 ++++- .../help/Invoke-AzCloudServiceReimage.md | 7 +- ...nvoke-AzCloudServiceRoleInstanceRebuild.md | 1 - ...nvoke-AzCloudServiceRoleInstanceReimage.md | 1 - .../CloudService/help/New-AzCloudService.md | 119 ++++++--- .../New-AzCloudServiceDiagnosticsExtension.md | 26 +- .../help/New-AzCloudServiceExtensionObject.md | 84 +++++- ...dServiceLoadBalancerConfigurationObject.md | 36 ++- ...adBalancerFrontendIPConfigurationObject.md | 47 ++-- ...loudServiceRemoteDesktopExtensionObject.md | 26 +- ...CloudServiceRoleProfilePropertiesObject.md | 14 +- ...ew-AzCloudServiceVaultSecretGroupObject.md | 32 ++- .../help/Remove-AzCloudService.md | 1 - .../help/Remove-AzCloudServiceRoleInstance.md | 59 ++++- .../help/Restart-AzCloudService.md | 59 ++++- .../Restart-AzCloudServiceRoleInstance.md | 25 +- .../help/Set-AzCloudServiceUpdateDomain.md | 49 +++- .../CloudService/help/Start-AzCloudService.md | 1 - .../CloudService/help/Stop-AzCloudService.md | 1 - .../help/Switch-AzCloudService.md | 26 +- .../help/Update-AzCloudService.md | 12 +- .../Az.CloudService/BreakingChangeIssues.csv | 121 +++++++++ .../Az.CloudService/ExampleIssues.csv | 17 ++ 93 files changed, 2168 insertions(+), 995 deletions(-) delete mode 100644 src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceExtensionObject.ps1 delete mode 100644 src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 delete mode 100644 src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRoleProfilePropertiesObject.ps1 delete mode 100644 src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceTags.cs delete mode 100644 src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceVaultCertificate.cs delete mode 100644 src/CloudService/CloudService.Autorest/custom/Serialization/ResourceInstanceViewStatus.cs delete mode 100644 src/CloudService/CloudService.Autorest/custom/Serialization/RoleInstanceTags.cs delete mode 100644 src/CloudService/CloudService.Autorest/custom/Serialization/StatusCodeCount.cs create mode 100644 src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceExtensionObject.ps1 create mode 100644 src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 create mode 100644 src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceRoleProfilePropertiesObject.ps1 create mode 100644 tools/StaticAnalysis/Exceptions/Az.CloudService/BreakingChangeIssues.csv create mode 100644 tools/StaticAnalysis/Exceptions/Az.CloudService/ExampleIssues.csv diff --git a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs index 464810880fba..a76bedb0fa31 100644 --- a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs +++ b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs @@ -24,3 +24,4 @@ [assembly: System.Reflection.AssemblyVersionAttribute("2.1.0")] [assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)] [assembly: System.CLSCompliantAttribute(false)] + diff --git a/src/CloudService/CloudService.Autorest/README.md b/src/CloudService/CloudService.Autorest/README.md index 869ffcc21ee7..accc0e827315 100644 --- a/src/CloudService/CloudService.Autorest/README.md +++ b/src/CloudService/CloudService.Autorest/README.md @@ -55,12 +55,6 @@ input-file: title: CloudService module-version: 0.1.0 -identity-correction-for-post: true - -# For new modules, please avoid setting 3.x using the use-extension method and instead, use 4.x as the default option -use-extension: - "@autorest/powershell": "3.x" - directive: - where: subject: ^CloudServiceOperatingSystemOSFamily$ @@ -71,8 +65,20 @@ directive: set: subject: CloudServiceOSVersion - where: - variant: ^Restart$|^RestartViaIdentity$|^Reimage$|^ReimageViaIdentity$|^Rebuild$|^RebuildViaIdentity$ - subject: ^CloudService$|^RebuildCloudService$ + variant: ^Rebuild$|^RebuildViaIdentity$|^RebuildViaJsonFilePathViaJsonFilePath$|^RebuildViaJsonStringViaJsonString$ + subject: RebuildCloudService + remove: true + - where: + subject: ^RebuildCloudService$ + set: + subject: Rebuild + - where: + variant: ^Restart$|^RestartViaIdentity$|^Reimage$|^ReimageViaIdentity$ + subject: ^CloudService$ + remove: true + - where: + variant: ^RebuildViaIdentityRoleInstance$ + subject: ^RebuildCloudServiceRoleInstance$ remove: true - where: @@ -88,11 +94,6 @@ directive: subject: CloudServiceRoleInstanceReimage verb: Invoke - - where: - subject: ^RebuildCloudService$ - variant: ^RebuildExpanded$|^RebuildViaIdentityExpanded$ - set: - subject: Rebuild - where: subject: ^RebuildCloudServiceRoleInstance$ variant: ^Rebuild$|^RebuildViaIdentity$ @@ -100,15 +101,15 @@ directive: subject: RoleInstanceRebuild - where: - subject: ^CloudServiceUpdateDomain$ - verb: Get + subject: ^CloudServicesUpdateDomain$ + verb: Get|Update remove: true - where: - subject: ^WalkCloudServiceUpdateDomain$ - variant: ^Walk$ + subject: ^WalkCloudServicesUpdateDomain$ + variant: ^Walk$|^WalkViaIdentity$|^WalkViaIdentityCloudService$|^WalkViaIdentityCloudServiceExpanded$|^WalkViaIdentityExpanded$|^WalkViaJsonFilePathViaJsonFilePath$|^WalkViaJsonStringViaJsonString$ remove: true - where: - subject: ^WalkCloudServiceUpdateDomain$ + subject: ^WalkCloudServicesUpdateDomain$ set: subject: UpdateDomain verb: Set @@ -119,7 +120,7 @@ directive: remove: true - where: subject: ^CloudServiceRoleInstance$ - verb: Remove + verb: Remove|Update remove: true - where: variant: ^Delete$|^DeleteViaIdentity$ @@ -320,203 +321,15 @@ directive: transform: >- return "string" - - where: - verb: Get|Update - subject: CloudService - set: - breaking-change: - deprecated-output-properties: - - Extension - - LoadBalancerConfiguration - - Secret - - Role - - Zone - new-output-properties: - - Extension - - LoadBalancerConfiguration - - Secret - - Role - - Zone - change-description: The types of the properties 'Extension', 'LoadBalancerConfiguration', 'Secret', 'Role', and 'Zone' will be changed from object to 'List'. - deprecated-by-version: 9.0.0 - deprecated-by-azversion: 15.0.0 - change-effective-date: 2025/11/03 - - - where: - verb: Get - subject: CloudServiceInstanceView - set: - breaking-change: - deprecated-output-properties: - - Statuses - - RoleInstanceStatusesSummary - - PrivateId - new-output-properties: - - Statuses - - RoleInstanceStatusesSummary - - PrivateId - change-description: The types of the properties 'Statuses', 'RoleInstanceStatusesSummary', and 'PrivateId' will be changed from object to 'List'. - deprecated-by-version: 9.0.0 - deprecated-by-azversion: 15.0.0 - change-effective-date: 2025/11/03 - - - where: - verb: Get - subject: NetworkInterface - set: - breaking-change: - deprecated-output-properties: - - ApplicationSecurityGroup - - CustomDnsConfig - - FlowLog - - LoadBalancerFrontendIPConfiguration - - NetworkSecurityGroupPropertiesNetworkInterface - - PrivateEndpointPropertiesNetworkInterface - - PrivateLinkServicePropertiesNetworkInterface - - IPConfiguration - - TapConfiguration - - PrivateEndpointConnection - - PrivateEndpointPropertiesIPConfiguration - - PrivateLinkServiceConnection - - ManualPrivateLinkServiceConnection - - PrivateLinkServicePropertiesIPConfiguration - - SecurityRule - - DefaultSecurityRule - - ApplicationGatewayIPConfiguration - - Delegation - - FlowLog - - IPConfiguration - - IPConfigurationProfile - - NetworkInterface - - PrivateEndpoint - - ResourceNavigationLink - - Route - - DefaultSecurityRule - - SecurityRule - - ServiceAssociationLink - - ServiceEndpointPolicy - - ServiceEndpoint - - NetworkSecurityGroupPropertiesSubnet - - RouteTablePropertiesSubnet - - IPAllocation - - PropertiesAddressPrefixes - - PropertiesNetworkSecurityGroupPropertiesSubnets - - HostedWorkload - - VisibilitySubscription - - DnsSettingDnsServer - - DnsSettingAppliedDnsServer - - AutoApprovalSubscription - - Fqdn - new-output-properties: - - ApplicationSecurityGroup - - CustomDnsConfig - - FlowLog - - LoadBalancerFrontendIPConfiguration - - NetworkSecurityGroupPropertiesNetworkInterface - - PrivateEndpointPropertiesNetworkInterface - - PrivateLinkServicePropertiesNetworkInterface - - IPConfiguration - - TapConfiguration - - PrivateEndpointConnection - - PrivateEndpointPropertiesIPConfiguration - - PrivateLinkServiceConnection - - ManualPrivateLinkServiceConnection - - PrivateLinkServicePropertiesIPConfiguration - - SecurityRule - - DefaultSecurityRule - - ApplicationGatewayIPConfiguration - - Delegation - - FlowLog - - IPConfiguration - - IPConfigurationProfile - - NetworkInterface - - PrivateEndpoint - - ResourceNavigationLink - - Route - - DefaultSecurityRule - - SecurityRule - - ServiceAssociationLink - - ServiceEndpointPolicy - - ServiceEndpoint - - NetworkSecurityGroupPropertiesSubnet - - RouteTablePropertiesSubnet - - IPAllocation - - PropertiesAddressPrefixes - - PropertiesNetworkSecurityGroupPropertiesSubnets - - HostedWorkload - - VisibilitySubscription - - DnsSettingDnsServer - - DnsSettingAppliedDnsServer - - AutoApprovalSubscription - - Fqdn - change-description: The types of the properties 'ApplicationSecurityGroup', 'CustomDnsConfig', 'FlowLog', 'LoadBalancerFrontendIPConfiguration', 'NetworkSecurityGroupPropertiesNetworkInterface', 'PrivateEndpointPropertiesNetworkInterface', 'PrivateLinkServicePropertiesNetworkInterface', 'IPConfiguration', 'TapConfiguration', 'PrivateEndpointConnection', 'PrivateEndpointPropertiesIPConfiguration', 'PrivateLinkServiceConnection', 'ManualPrivateLinkServiceConnection', 'PrivateLinkServicePropertiesIPConfiguration', 'SecurityRule', 'DefaultSecurityRule', 'ApplicationGatewayIPConfiguration', 'Delegation', 'FlowLog', 'IPConfiguration', 'IPConfigurationProfile', 'NetworkInterface', 'PrivateEndpoint', 'ResourceNavigationLink', 'Route', 'DefaultSecurityRule', 'SecurityRule', 'ServiceAssociationLink', 'ServiceEndpointPolicy', 'ServiceEndpoint', 'NetworkSecurityGroupPropertiesSubnet', 'RouteTablePropertiesSubnet', 'IPAllocation', 'PropertiesAddressPrefixes', 'PropertiesNetworkSecurityGroupPropertiesSubnets', 'HostedWorkload', 'VisibilitySubscription', 'DnsSettingDnsServer', 'DnsSettingAppliedDnsServer', 'AutoApprovalSubscription', 'Fqdn' will be changed from object to 'List'. - deprecated-by-version: 9.0.0 - deprecated-by-azversion: 15.0.0 - change-effective-date: 2025/11/03 - - - where: - verb: Get - subject: CloudServiceOSFamily - set: - breaking-change: - deprecated-output-properties: - - Version - new-output-properties: - - Version - change-description: The types of the properties 'Version' will be changed from object to 'List'. - deprecated-by-version: 9.0.0 - deprecated-by-azversion: 15.0.0 - change-effective-date: 2025/11/03 - - - where: - verb: Get - subject: PublicIPAddress - set: - breaking-change: - deprecated-output-properties: - - Zone - - IPTag - - PublicIPAddress - - PublicIPPrefix - - Subnet - new-output-properties: - - Zone - - IPTag - - PublicIPAddress - - PublicIPPrefix - - Subnet - change-description: The types of the properties 'Zone', 'IPTag', 'PublicIPAddress', 'PublicIPPrefix', and 'Subnet' will be changed from object to 'List'. - deprecated-by-version: 9.0.0 - deprecated-by-azversion: 15.0.0 - change-effective-date: 2025/11/03 - - - where: - verb: Get - subject: CloudServiceRoleInstance - set: - breaking-change: - deprecated-output-properties: - - NetworkProfileNetworkInterface - - InstanceViewStatuses - new-output-properties: - - NetworkProfileNetworkInterface - - InstanceViewStatuses - change-description: The types of the properties 'NetworkProfileNetworkInterface' and 'InstanceViewStatuses' will be changed from object to 'List'. - deprecated-by-version: 9.0.0 - deprecated-by-azversion: 15.0.0 - change-effective-date: 2025/11/03 - - - where: - verb: Get - subject: CloudServiceRoleInstanceView - set: - breaking-change: - deprecated-output-properties: - - Statuses - new-output-properties: - - Statuses - change-description: The types of the properties 'Statuses' will be changed from object to 'List'. - deprecated-by-version: 9.0.0 - deprecated-by-azversion: 15.0.0 - change-effective-date: 2025/11/03 + - model-cmdlet: + - model-name: Extension + cmdlet-name: New-AzCloudServiceExtensionObject + - model-name: LoadBalancerConfiguration + cmdlet-name: New-AzCloudServiceLoadBalancerConfigurationObject + # - model-name: LoadBalancerFrontendIPConfiguration + # cmdlet-name: New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject + - model-name: CloudServiceRoleProfileProperties + cmdlet-name: New-AzCloudServiceRoleProfilePropertiesObject + # - model-name: CloudServiceVaultSecretGroup + # cmdlet-name: New-AzCloudServiceVaultSecretGroupObject ``` diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudService.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudService.ps1 index 89c664ff85cc..31b01574fc4b 100644 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudService.ps1 +++ b/src/CloudService/CloudService.Autorest/custom/New-AzCloudService.ps1 @@ -21,8 +21,7 @@ Create a CloudService Resource #> function New-AzCloudService { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudService')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudService", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudService", DeprecatedOutputProperties = ("Zone, Extension, LoadBalancerConfiguration, Secret, Role"), NewOutputProperties = ("Zone, Extension, LoadBalancerConfiguration, Secret, Role will be changed from object to 'List'."))] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudService')] [CmdletBinding(PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')] param( [Parameter(ParameterSetName='quickCreateParameterSetWithoutStorage', Mandatory)] @@ -87,7 +86,7 @@ function New-AzCloudService { [Parameter(ParameterSetName='quickCreateParameterSetWithoutStorage', HelpMessage="Describes a cloud service extension profile.")] [Parameter(ParameterSetName='quickCreateParameterSetWithStorage', HelpMessage="Describes a cloud service extension profile.")] [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Body')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceExtensionProfile] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceExtensionProfile] # Describes a cloud service extension profile. # To construct, see NOTES section for EXTENSIONPROFILE properties and create a hash table. ${ExtensionProfile}, @@ -105,16 +104,16 @@ function New-AzCloudService { [Parameter(ParameterSetName='quickCreateParameterSetWithoutStorage')] [Parameter(ParameterSetName='quickCreateParameterSetWithStorage')] [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Body')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Info(PossibleTypes=([Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceTags]))] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Info(PossibleTypes=([Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceTags]))] [System.Collections.Hashtable] # Resource tags. ${Tag}, [Parameter(ParameterSetName='quickCreateParameterSetWithoutStorage', HelpMessage="Update mode for the cloud service.")] [Parameter(ParameterSetName='quickCreateParameterSetWithStorage', HelpMessage="Update mode for the cloud service.")] - [ArgumentCompleter([Microsoft.Azure.PowerShell.Cmdlets.CloudService.Support.CloudServiceUpgradeMode])] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.PSArgumentCompleterAttribute("Auto", "Manual", "Simultaneous")] [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Body')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Support.CloudServiceUpgradeMode] + [System.String] # Update mode for the cloud service. # Role instances are allocated to update domains when the service is deployed. # Updates can be initiated manually in each update domain or initiated automatically in all update domains.Possible Values are

**Auto**

**Manual**

**Simultaneous**

If not specified, the default value is Auto. diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceDiagnosticsExtension.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceDiagnosticsExtension.ps1 index 74dec4255146..d94e4d8498f4 100644 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceDiagnosticsExtension.ps1 +++ b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceDiagnosticsExtension.ps1 @@ -20,8 +20,7 @@ Create a in-memory object for Diagnostics Extension #> function New-AzCloudServiceDiagnosticsExtension { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension", DeprecatedOutputProperties = ("RolesAppliedTo System.String[]"), NewOutputProperties = ("RolesAppliedTo System.Collections.Generic.List`1[System.String]"))] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension')] param( [Parameter(HelpMessage="Name of Diagnostics Extension.", Mandatory)] [string] $Name, diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceExtensionObject.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceExtensionObject.ps1 deleted file mode 100644 index e05d79d20324..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceExtensionObject.ps1 +++ /dev/null @@ -1,68 +0,0 @@ - -# ---------------------------------------------------------------------------------- -# -# Copyright Microsoft Corporation -# Licensed under the Apache License, Version 2.0 (the \"License\"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# http://www.apache.org/licenses/LICENSE-2.0 -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an \"AS IS\" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -# ---------------------------------------------------------------------------------- - -<# -.Synopsis -Create a in-memory object for Extension -.Description -Create a in-memory object for Extension -#> -function New-AzCloudServiceExtensionObject { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension", DeprecatedOutputProperties = ("RolesAppliedTo System.String[]"), NewOutputProperties = ("RolesAppliedTo System.Collections.Generic.List`1[System.String]"))] - [CmdletBinding(PositionalBinding=$false)] - Param( - - [Parameter(HelpMessage="Explicitly specify whether CRP can automatically upgrade typeHandlerVersion to higher minor versions when they become available.")] - [bool] - $AutoUpgradeMinorVersion, - [Parameter(HelpMessage="Name.")] - [string] - $Name, - [Parameter(HelpMessage="Protected settings for the extension which are encrypted before sent to the VM.")] - [string] - $ProtectedSetting, - [Parameter(HelpMessage="Publisher.")] - [string] - $Publisher, - [Parameter(HelpMessage="RolesAppliedTo.")] - [string[]] - $RolesAppliedTo, - [Parameter(HelpMessage="Public settings for the extension.")] - [string] - $Setting, - [Parameter(HelpMessage="Type.")] - [string] - $Type, - [Parameter(HelpMessage="TypeHandlerVersion.")] - [string] - $TypeHandlerVersion - ) - - process { - $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension]::New() - - $Object.AutoUpgradeMinorVersion = $AutoUpgradeMinorVersion - $Object.Name = $Name - $Object.ProtectedSetting = $ProtectedSetting - $Object.Publisher = $Publisher - $Object.RolesAppliedTo = $RolesAppliedTo - $Object.Setting = $Setting - $Object.Type = $Type - $Object.TypeHandlerVersion = $TypeHandlerVersion - return $Object - } -} - diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 deleted file mode 100644 index ba1c9fce10c9..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 +++ /dev/null @@ -1,44 +0,0 @@ - -# ---------------------------------------------------------------------------------- -# -# Copyright Microsoft Corporation -# Licensed under the Apache License, Version 2.0 (the \"License\"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# http://www.apache.org/licenses/LICENSE-2.0 -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an \"AS IS\" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -# ---------------------------------------------------------------------------------- - -<# -.Synopsis -Create a in-memory object for LoadBalancerConfiguration -.Description -Create a in-memory object for LoadBalancerConfiguration -#> -function New-AzCloudServiceLoadBalancerConfigurationObject { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerConfiguration')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerConfiguration", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerConfiguration", DeprecatedOutputProperties = ("FrontendIPConfiguration Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ILoadBalancerFrontendIPConfiguration"), NewOutputProperties = ("FrontendIPConfiguration System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ILoadBalancerFrontendIPConfiguration]"))] - [CmdletBinding(PositionalBinding=$false)] - Param( - - [Parameter(HelpMessage="FrontendIPConfiguration.")] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ILoadBalancerFrontendIPConfiguration[]] - $FrontendIPConfiguration, - [Parameter(HelpMessage="Name of LoadBalancerConfiguration.")] - [string] - $Name - ) - - process { - $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerConfiguration]::New() - - $Object.FrontendIPConfiguration = $FrontendIPConfiguration - $Object.Name = $Name - return $Object - } -} - diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.ps1 index c873b11234b9..f9e8e721b086 100644 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.ps1 +++ b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.ps1 @@ -1,55 +1,63 @@ # ---------------------------------------------------------------------------------- -# -# Copyright Microsoft Corporation -# Licensed under the Apache License, Version 2.0 (the \"License\"); +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # http://www.apache.org/licenses/LICENSE-2.0 # Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an \"AS IS\" BASIS, +# distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. +# Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code +# is regenerated. # ---------------------------------------------------------------------------------- <# .Synopsis -Create a in-memory object for LoadBalancerFrontendIPConfiguration +Create an in-memory object for LoadBalancerFrontendIPConfiguration. .Description -Create a in-memory object for LoadBalancerFrontendIPConfiguration +Create an in-memory object for LoadBalancerFrontendIPConfiguration. + +.Outputs +Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerFrontendIPConfiguration +.Link +https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceloadbalancerfrontendipconfigurationobject #> function New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerFrontendIPConfiguration')] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.ModelCmdletAttribute()] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerFrontendIPConfiguration')] [CmdletBinding(PositionalBinding=$false)] Param( - [Parameter(HelpMessage="Name of FrontendIpConfiguration.")] + [Parameter(Mandatory, HelpMessage="The name of the resource that is unique within the set of frontend IP configurations used by the load balancer. This name can be used to access the resource.")] [string] $Name, [Parameter(ParameterSetName="DefaultParameterSet", HelpMessage="Resource Id.")] [string] $PublicIPAddressId, - [Parameter(ParameterSetName="PrivateIP", HelpMessage="Private IP Address")] + [Parameter(ParameterSetName="PrivateIP", HelpMessage="The virtual network private IP address of the IP configuration.")] [string] $PrivateIPAddress, - [Parameter(ParameterSetName="PrivateIP", HelpMessage="Subnet ID")] + [Parameter(ParameterSetName="PrivateIP", HelpMessage="Resource Id.")] [string] $SubnetId ) process { - $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerFrontendIPConfiguration]::New() + $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerFrontendIPConfiguration]::New() - $Object.Name = $Name - if ($PSBoundParameters.ContainsKey("PublicIPAddressId")) { + if ($PSBoundParameters.ContainsKey('Name')) { + $Object.Name = $Name + } + if ($PSBoundParameters.ContainsKey('PublicIPAddressId')) { $Object.PublicIPAddressId = $PublicIPAddressId } - if ($PSBoundParameters.ContainsKey("PrivateIPAddress")) { - $Object.privateIPAddress = $PrivateIPAddress + if ($PSBoundParameters.ContainsKey('PrivateIPAddress')) { + $Object.PrivateIPAddress = $PrivateIPAddress $Object.SubnetId = $SubnetId } - return $Object } } diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRemoteDesktopExtensionObject.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRemoteDesktopExtensionObject.ps1 index 63c0a4942b5d..982db8009839 100644 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRemoteDesktopExtensionObject.ps1 +++ b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRemoteDesktopExtensionObject.ps1 @@ -20,8 +20,8 @@ Create a in-memory object for Remote Desktop Extension #> function New-AzCloudServiceRemoteDesktopExtensionObject { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension", DeprecatedOutputProperties = ("RolesAppliedTo System.String[]"), NewOutputProperties = ("RolesAppliedTo System.Collections.Generic.List`1[System.String]"))] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.ModelCmdletAttribute()] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension')] param( [Parameter(HelpMessage="Name of Remote Desktop Extension.", Mandatory)] [string] $Name, diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRoleProfilePropertiesObject.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRoleProfilePropertiesObject.ps1 deleted file mode 100644 index 3dedd0aa24bd..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceRoleProfilePropertiesObject.ps1 +++ /dev/null @@ -1,51 +0,0 @@ - -# ---------------------------------------------------------------------------------- -# -# Copyright Microsoft Corporation -# Licensed under the Apache License, Version 2.0 (the \"License\"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# http://www.apache.org/licenses/LICENSE-2.0 -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an \"AS IS\" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -# ---------------------------------------------------------------------------------- - -<# -.Synopsis -Create a in-memory object for CloudServiceRoleProfileProperties -.Description -Create a in-memory object for CloudServiceRoleProfileProperties -#> -function New-AzCloudServiceRoleProfilePropertiesObject { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudServiceRoleProfileProperties')] - [CmdletBinding(PositionalBinding=$false)] - Param( - - [Parameter(HelpMessage="Name of role profile.")] - [string] - $Name, - [Parameter(HelpMessage="Specifies the number of role instances in the cloud service.")] - [long] - $SkuCapacity, - [Parameter(HelpMessage="The sku name.")] - [string] - $SkuName, - [Parameter(HelpMessage="SkuTier.")] - [string] - $SkuTier - ) - - process { - $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudServiceRoleProfileProperties]::New() - - $Object.Name = $Name - $Object.SkuCapacity = $SkuCapacity - $Object.SkuName = $SkuName - $Object.SkuTier = $SkuTier - return $Object - } -} - diff --git a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceVaultSecretGroupObject.ps1 b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceVaultSecretGroupObject.ps1 index 69068536137f..4d8d5bd27da1 100644 --- a/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceVaultSecretGroupObject.ps1 +++ b/src/CloudService/CloudService.Autorest/custom/New-AzCloudServiceVaultSecretGroupObject.ps1 @@ -1,27 +1,33 @@ + # ---------------------------------------------------------------------------------- -# -# Copyright Microsoft Corporation -# Licensed under the Apache License, Version 2.0 (the \"License\"); +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # http://www.apache.org/licenses/LICENSE-2.0 # Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an \"AS IS\" BASIS, +# distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. +# Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code +# is regenerated. # ---------------------------------------------------------------------------------- <# .Synopsis -Create a in-memory object for Vault Secret Group +Create an in-memory object for CloudServiceVaultSecretGroup. .Description -Create a in-memory object for Secret Group -#> +Create an in-memory object for CloudServiceVaultSecretGroup. +.Outputs +Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceVaultSecretGroup +.Link +https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudservicevaultsecretgroupobject +#> function New-AzCloudServiceVaultSecretGroupObject { - [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudServiceVaultSecretGroup')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudServiceVaultSecretGroup", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceVaultSecretGroup", DeprecatedOutputProperties = ("VaultCertificate Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceVaultCertificate"), NewOutputProperties = ("VaultCertificate System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceVaultCertificate]"))] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.ModelCmdletAttribute()] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceVaultSecretGroup')] [CmdletBinding(PositionalBinding=$false)] Param( [Parameter(HelpMessage="Key Vault Resource Id.")] @@ -49,3 +55,4 @@ function New-AzCloudServiceVaultSecretGroupObject { return $cloudServiceVaultSecretGroup } } + diff --git a/src/CloudService/CloudService.Autorest/custom/Serialization/CloudService.cs b/src/CloudService/CloudService.Autorest/custom/Serialization/CloudService.cs index b1b534a33154..36194743e02f 100644 --- a/src/CloudService/CloudService.Autorest/custom/Serialization/CloudService.cs +++ b/src/CloudService/CloudService.Autorest/custom/Serialization/CloudService.cs @@ -3,24 +3,13 @@ using System.Text; using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json; -namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904 +namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models { - public partial class CloudService - { - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Origin(Microsoft.Azure.PowerShell.Cmdlets.CloudService.PropertyOrigin.Owned)] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.FormatTable(Index = 0)] - public string ResourceGroupName - { - get { - var _match = new global::System.Text.RegularExpressions.Regex("^/subscriptions/(?[^/]+)/resourceGroups/(?[^/]+)/providers/Microsoft.Compute/cloudServices/(?[^/]+)$").Match(this.Id); - if (!_match.Success) { - return null; - } - return _match.Groups["resourceGroupName"].Value; - } - } - } - + /// + /// Adds the [-ResourceGroupName] property to the ICloudService interface. + /// This property is required by the Get/New/Update-AzCloudService cmdlets for output, + /// but was missing in the generated ICloudService.cs file. + /// public partial interface ICloudService { [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Info( @@ -31,4 +20,4 @@ public partial interface ICloudService PossibleTypes = new [] { typeof(string) })] string ResourceGroupName { get; } } -} +} \ No newline at end of file diff --git a/src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceTags.cs b/src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceTags.cs deleted file mode 100644 index c95d60efe9c7..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceTags.cs +++ /dev/null @@ -1,15 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Text; -using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json; - -namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904 -{ - public partial class CloudServiceTags - { - public override string ToString() - { - return this.ToJsonString(); - } - } -} diff --git a/src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceVaultCertificate.cs b/src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceVaultCertificate.cs deleted file mode 100644 index 97b7854a6868..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/Serialization/CloudServiceVaultCertificate.cs +++ /dev/null @@ -1,15 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Text; -using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json; - -namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904 -{ - public partial class CloudServiceVaultCertificate - { - public override string ToString() - { - return this.CertificateUrl; - } - } -} diff --git a/src/CloudService/CloudService.Autorest/custom/Serialization/ResourceInstanceViewStatus.cs b/src/CloudService/CloudService.Autorest/custom/Serialization/ResourceInstanceViewStatus.cs deleted file mode 100644 index 9b886b4b2dcb..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/Serialization/ResourceInstanceViewStatus.cs +++ /dev/null @@ -1,15 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Text; -using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json; - -namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904 -{ - public partial class ResourceInstanceViewStatus - { - public override string ToString() - { - return this.DisplayStatus; - } - } -} diff --git a/src/CloudService/CloudService.Autorest/custom/Serialization/RoleInstanceTags.cs b/src/CloudService/CloudService.Autorest/custom/Serialization/RoleInstanceTags.cs deleted file mode 100644 index 62adda463cde..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/Serialization/RoleInstanceTags.cs +++ /dev/null @@ -1,15 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Text; -using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json; - -namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904 -{ - public partial class RoleInstanceTags - { - public override string ToString() - { - return this.ToJsonString(); - } - } -} diff --git a/src/CloudService/CloudService.Autorest/custom/Serialization/StatusCodeCount.cs b/src/CloudService/CloudService.Autorest/custom/Serialization/StatusCodeCount.cs deleted file mode 100644 index f68a60841bc2..000000000000 --- a/src/CloudService/CloudService.Autorest/custom/Serialization/StatusCodeCount.cs +++ /dev/null @@ -1,15 +0,0 @@ -using System; -using System.Collections.Generic; -using System.Text; -using Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.Json; - -namespace Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904 -{ - public partial class StatusCodeCount - { - public override string ToString() - { - return this.ToJsonString(); - } - } -} diff --git a/src/CloudService/CloudService.Autorest/custom/Switch-AzCloudService.ps1 b/src/CloudService/CloudService.Autorest/custom/Switch-AzCloudService.ps1 index 7a13cbcfdf56..5aa1a4f48530 100644 --- a/src/CloudService/CloudService.Autorest/custom/Switch-AzCloudService.ps1 +++ b/src/CloudService/CloudService.Autorest/custom/Switch-AzCloudService.ps1 @@ -39,7 +39,7 @@ function Switch-AzCloudService { [Parameter(Mandatory=$true, ParameterSetName="CloudService")] [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Path')] - [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudService] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudService] ${CloudService}, [Parameter(Mandatory=$true, ParameterSetName="CloudServiceName")] @@ -237,24 +237,24 @@ function GetVIPSwapRequestBody() { return @" { - "frontendIPConfigurations": [ - { - "id": "#LBFE1#", - "properties": { - "publicIPAddress": { - "id": "#PIP2#" - } - } - }, - { - "id": "#LBFE2#", - "properties": { - "publicIPAddress": { - "id": "#PIP1#" - } - } - } - ] + "frontendIPConfigurations": [ + { + "id": "#LBFE1#", + "properties": { + "publicIPAddress": { + "id": "#PIP2#" + } + } + }, + { + "id": "#LBFE2#", + "properties": { + "publicIPAddress": { + "id": "#PIP1#" + } + } + } + ] } "@ } diff --git a/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceExtensionObject.ps1 b/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceExtensionObject.ps1 new file mode 100644 index 000000000000..69a7ed5ca658 --- /dev/null +++ b/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceExtensionObject.ps1 @@ -0,0 +1,112 @@ + +# ---------------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# http://www.apache.org/licenses/LICENSE-2.0 +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code +# is regenerated. +# ---------------------------------------------------------------------------------- + +<# +.Synopsis +Create an in-memory object for Extension. +.Description +Create an in-memory object for Extension. + +.Outputs +Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension +.Link +https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceextensionobject +#> +function New-AzCloudServiceExtensionObject { + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.ModelCmdletAttribute()] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension')] + [CmdletBinding(PositionalBinding=$false)] + Param( + + [Parameter(HelpMessage="Explicitly specify whether platform can automatically upgrade typeHandlerVersion to higher minor versions when they become available.")] + [bool] + $AutoUpgradeMinorVersion, + [Parameter(HelpMessage="Tag to force apply the provided public and protected settings. + Changing the tag value allows for re-running the extension without changing any of the public or protected settings. + If forceUpdateTag is not changed, updates to public or protected settings would still be applied by the handler. + If neither forceUpdateTag nor any of public or protected settings change, extension would flow to the role instance with the same sequence-number, and + it is up to handler implementation whether to re-run it or not.")] + [string] + $ForceUpdateTag, + [Parameter(HelpMessage="The name of the extension.")] + [string] + $Name, + [Parameter(HelpMessage="Protected settings for the extension which are encrypted before sent to the role instance.")] + [string] + $ProtectedSetting, + [Parameter(HelpMessage="Secret URL which contains the protected settings of the extension.")] + [string] + $ProtectedSettingFromKeyVaultSecretUrl, + [Parameter(HelpMessage="The name of the extension handler publisher.")] + [string] + $Publisher, + [Parameter(HelpMessage="Optional list of roles to apply this extension. If property is not specified or '*' is specified, extension is applied to all roles in the cloud service.")] + [string[]] + $RolesAppliedTo, + [Parameter(HelpMessage="Public settings for the extension. For JSON extensions, this is the JSON settings for the extension. For XML Extension (like RDP), this is the XML setting for the extension.")] + [string] + $Setting, + [Parameter(HelpMessage="Resource Id.")] + [string] + $SourceVaultId, + [Parameter(HelpMessage="Specifies the type of the extension.")] + [string] + $Type, + [Parameter(HelpMessage="Specifies the version of the extension. Specifies the version of the extension. If this element is not specified or an asterisk (*) is used as the value, the latest version of the extension is used. If the value is specified with a major version number and an asterisk as the minor version number (X.), the latest minor version of the specified major version is selected. If a major version number and a minor version number are specified (X.Y), the specific extension version is selected. If a version is specified, an auto-upgrade is performed on the role instance.")] + [string] + $TypeHandlerVersion + ) + + process { + $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension]::New() + + if ($PSBoundParameters.ContainsKey('AutoUpgradeMinorVersion')) { + $Object.AutoUpgradeMinorVersion = $AutoUpgradeMinorVersion + } + if ($PSBoundParameters.ContainsKey('ForceUpdateTag')) { + $Object.ForceUpdateTag = $ForceUpdateTag + } + if ($PSBoundParameters.ContainsKey('Name')) { + $Object.Name = $Name + } + if ($PSBoundParameters.ContainsKey('ProtectedSetting')) { + $Object.ProtectedSetting = $ProtectedSetting + } + if ($PSBoundParameters.ContainsKey('ProtectedSettingFromKeyVaultSecretUrl')) { + $Object.ProtectedSettingFromKeyVaultSecretUrl = $ProtectedSettingFromKeyVaultSecretUrl + } + if ($PSBoundParameters.ContainsKey('Publisher')) { + $Object.Publisher = $Publisher + } + if ($PSBoundParameters.ContainsKey('RolesAppliedTo')) { + $Object.RolesAppliedTo = $RolesAppliedTo + } + if ($PSBoundParameters.ContainsKey('Setting')) { + $Object.Setting = $Setting + } + if ($PSBoundParameters.ContainsKey('SourceVaultId')) { + $Object.SourceVaultId = $SourceVaultId + } + if ($PSBoundParameters.ContainsKey('Type')) { + $Object.Type = $Type + } + if ($PSBoundParameters.ContainsKey('TypeHandlerVersion')) { + $Object.TypeHandlerVersion = $TypeHandlerVersion + } + return $Object + } +} + diff --git a/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 b/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 new file mode 100644 index 000000000000..fc0c37916d9d --- /dev/null +++ b/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceLoadBalancerConfigurationObject.ps1 @@ -0,0 +1,60 @@ + +# ---------------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# http://www.apache.org/licenses/LICENSE-2.0 +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code +# is regenerated. +# ---------------------------------------------------------------------------------- + +<# +.Synopsis +Create an in-memory object for LoadBalancerConfiguration. +.Description +Create an in-memory object for LoadBalancerConfiguration. + +.Outputs +Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerConfiguration +.Link +https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceloadbalancerconfigurationobject +#> +function New-AzCloudServiceLoadBalancerConfigurationObject { + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.ModelCmdletAttribute()] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerConfiguration')] + [CmdletBinding(PositionalBinding=$false)] + Param( + + [Parameter(Mandatory, HelpMessage="Specifies the frontend IP to be used for the load balancer. Only IPv4 frontend IP address is supported. Each load balancer configuration must have exactly one frontend IP configuration.")] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ILoadBalancerFrontendIPConfiguration[]] + $FrontendIPConfiguration, + [Parameter(HelpMessage="Resource Id.")] + [string] + $Id, + [Parameter(Mandatory, HelpMessage="The name of the Load balancer.")] + [string] + $Name + ) + + process { + $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerConfiguration]::New() + + if ($PSBoundParameters.ContainsKey('FrontendIPConfiguration')) { + $Object.FrontendIPConfiguration = $FrontendIPConfiguration + } + if ($PSBoundParameters.ContainsKey('Id')) { + $Object.Id = $Id + } + if ($PSBoundParameters.ContainsKey('Name')) { + $Object.Name = $Name + } + return $Object + } +} + diff --git a/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceRoleProfilePropertiesObject.ps1 b/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceRoleProfilePropertiesObject.ps1 new file mode 100644 index 000000000000..eed336469f47 --- /dev/null +++ b/src/CloudService/CloudService.Autorest/custom/autogen-model-cmdlets/New-AzCloudServiceRoleProfilePropertiesObject.ps1 @@ -0,0 +1,66 @@ + +# ---------------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# http://www.apache.org/licenses/LICENSE-2.0 +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code +# is regenerated. +# ---------------------------------------------------------------------------------- + +<# +.Synopsis +Create an in-memory object for CloudServiceRoleProfileProperties. +.Description +Create an in-memory object for CloudServiceRoleProfileProperties. + +.Outputs +Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceRoleProfileProperties +.Link +https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceroleprofilepropertiesobject +#> +function New-AzCloudServiceRoleProfilePropertiesObject { + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.ModelCmdletAttribute()] + [OutputType('Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceRoleProfileProperties')] + [CmdletBinding(PositionalBinding=$false)] + Param( + + [Parameter(HelpMessage="Resource name.")] + [string] + $Name, + [Parameter(HelpMessage="Specifies the number of role instances in the cloud service.")] + [long] + $SkuCapacity, + [Parameter(HelpMessage="The sku name. NOTE: If the new SKU is not supported on the hardware the cloud service is currently on, you need to delete and recreate the cloud service or move back to the old sku.")] + [string] + $SkuName, + [Parameter(HelpMessage="Specifies the tier of the cloud service. Possible Values are

**Standard**

**Basic**.")] + [string] + $SkuTier + ) + + process { + $Object = [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceRoleProfileProperties]::New() + + if ($PSBoundParameters.ContainsKey('Name')) { + $Object.Name = $Name + } + if ($PSBoundParameters.ContainsKey('SkuCapacity')) { + $Object.SkuCapacity = $SkuCapacity + } + if ($PSBoundParameters.ContainsKey('SkuName')) { + $Object.SkuName = $SkuName + } + if ($PSBoundParameters.ContainsKey('SkuTier')) { + $Object.SkuTier = $SkuTier + } + return $Object + } +} + diff --git a/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md b/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md index 09ee3a1ea1f6..2b9def07a448 100644 --- a/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md @@ -1,6 +1,6 @@ --- Module Name: Az.CloudService -Module Guid: b17f5e3c-8402-4201-baa8-385dd3e406ff +Module Guid: 7b3ddd84-935e-4839-bbe3-ba7d166d2523 Download Help Link: https://learn.microsoft.com/powershell/module/az.cloudservice Help Version: 1.0.0.0 Locale: en-US @@ -53,29 +53,29 @@ If you do not want to initialize storage resources, you can use Reimage Role Ins The Reimage Role Instance asynchronous operation reinstalls the operating system on instances of web roles or worker roles. ### [New-AzCloudService](New-AzCloudService.md) -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. ### [New-AzCloudServiceDiagnosticsExtension](New-AzCloudServiceDiagnosticsExtension.md) Create a in-memory object for Diagnostics Extension ### [New-AzCloudServiceExtensionObject](New-AzCloudServiceExtensionObject.md) -Create a in-memory object for Extension +Create an in-memory object for Extension. ### [New-AzCloudServiceLoadBalancerConfigurationObject](New-AzCloudServiceLoadBalancerConfigurationObject.md) -Create a in-memory object for LoadBalancerConfiguration +Create an in-memory object for LoadBalancerConfiguration. ### [New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject](New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md) -Create a in-memory object for LoadBalancerFrontendIPConfiguration +Create an in-memory object for LoadBalancerFrontendIPConfiguration. ### [New-AzCloudServiceRemoteDesktopExtensionObject](New-AzCloudServiceRemoteDesktopExtensionObject.md) Create a in-memory object for Remote Desktop Extension ### [New-AzCloudServiceRoleProfilePropertiesObject](New-AzCloudServiceRoleProfilePropertiesObject.md) -Create a in-memory object for CloudServiceRoleProfileProperties +Create an in-memory object for CloudServiceRoleProfileProperties. ### [New-AzCloudServiceVaultSecretGroupObject](New-AzCloudServiceVaultSecretGroupObject.md) -Create a in-memory object for Vault Secret Group +Create an in-memory object for CloudServiceVaultSecretGroup. ### [Remove-AzCloudService](Remove-AzCloudService.md) Deletes a cloud service. @@ -90,7 +90,7 @@ Restarts one or more role instances in a cloud service. The Reboot Role Instance asynchronous operation requests a reboot of a role instance in the cloud service. ### [Set-AzCloudServiceUpdateDomain](Set-AzCloudServiceUpdateDomain.md) -Updates the role instances in the specified update domain. +Walk the role instances in the specified walk domain. ### [Start-AzCloudService](Start-AzCloudService.md) Starts the cloud service. @@ -103,6 +103,6 @@ Note that resources are still attached and you are getting charged for the resou Swaps VIPs between two cloud service (extended support) load balancers. ### [Update-AzCloudService](Update-AzCloudService.md) -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudService.md index 92b31c404b8c..72be946575b8 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudService.md @@ -103,7 +103,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -172,7 +171,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudService +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudService ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceInstanceView.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceInstanceView.md index 965b094510d8..bb74c8f68931 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceInstanceView.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceInstanceView.md @@ -148,7 +148,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceInstanceView +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceInstanceView ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceNetworkInterface.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceNetworkInterface.md index 4983379c15ce..99ec7748a3ee 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceNetworkInterface.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceNetworkInterface.md @@ -31,6 +31,18 @@ Get-AzCloudServiceNetworkInterface -InputObject [-Expand [-DefaultProfile ] [] ``` +### GetViaIdentityCloudService +``` +Get-AzCloudServiceNetworkInterface -CloudServiceInputObject -Name + -RoleInstanceName [-Expand ] [-DefaultProfile ] [] +``` + +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceNetworkInterface -Name -RoleInstanceInputObject + [-Expand ] [-DefaultProfile ] [] +``` + ### List ``` Get-AzCloudServiceNetworkInterface -CloudServiceName -ResourceGroupName @@ -59,6 +71,21 @@ Gets all the network interfaces for a given cloud service object. ## PARAMETERS +### -CloudServiceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityCloudService +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -CloudServiceName The name of the cloud service. @@ -95,7 +122,7 @@ Expands referenced resources. ```yaml Type: System.String -Parameter Sets: Get, GetViaIdentity +Parameter Sets: Get, GetViaIdentity, GetViaIdentityCloudService, GetViaIdentityRoleInstance Aliases: Required: False @@ -107,7 +134,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -126,7 +152,7 @@ The name of the network interface. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityCloudService, GetViaIdentityRoleInstance Aliases: NetworkInterfaceName Required: True @@ -151,12 +177,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName The name of role instance. ```yaml Type: System.String -Parameter Sets: Get, List +Parameter Sets: Get, GetViaIdentityCloudService, List Aliases: Required: True @@ -191,7 +232,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.INetworkInterface +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.INetworkInterface ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSFamily.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSFamily.md index 7181c41f1a83..0fd5e38b3829 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSFamily.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSFamily.md @@ -30,6 +30,12 @@ Get-AzCloudServiceOSFamily -InputObject [-DefaultProfile [] ``` +### GetViaIdentityLocation +``` +Get-AzCloudServiceOSFamily -LocationInputObject -OSFamilyName + [-DefaultProfile ] [] +``` + ## DESCRIPTION Gets properties of a guest operating system family that can be specified in the XML service configuration (.cscfg) for a cloud service. @@ -85,7 +91,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -114,12 +119,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -LocationInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityLocation +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -OSFamilyName Name of the OS family. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityLocation Aliases: Required: True @@ -154,7 +174,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IOSFamily +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IOSFamily ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSVersion.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSVersion.md index d9421135599a..2cfd15cefec3 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSVersion.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceOSVersion.md @@ -30,6 +30,12 @@ Get-AzCloudServiceOSVersion -InputObject [-DefaultProfil [] ``` +### GetViaIdentityLocation +``` +Get-AzCloudServiceOSVersion -LocationInputObject -OSVersionName + [-DefaultProfile ] [] +``` + ## DESCRIPTION Gets properties of a guest operating system version that can be specified in the XML service configuration (.cscfg) for a cloud service. @@ -85,7 +91,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -114,12 +119,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -LocationInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityLocation +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -OSVersionName Name of the OS version. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityLocation Aliases: Required: True @@ -154,7 +174,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IOSVersion +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IOSVersion ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServicePublicIPAddress.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServicePublicIPAddress.md index 9102e0056246..57ae4f21d15b 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServicePublicIPAddress.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServicePublicIPAddress.md @@ -31,6 +31,33 @@ Get-AzCloudServicePublicIPAddress -InputObject [-Expand [-DefaultProfile ] [] ``` +### GetViaIdentityCloudService +``` +Get-AzCloudServicePublicIPAddress -CloudServiceInputObject + -IPConfigurationName -Name -NetworkInterfaceName -RoleInstanceName + [-Expand ] [-DefaultProfile ] [] +``` + +### GetViaIdentityIpconfiguration +``` +Get-AzCloudServicePublicIPAddress -IpconfigurationInputObject -Name + [-Expand ] [-DefaultProfile ] [] +``` + +### GetViaIdentityNetworkInterface +``` +Get-AzCloudServicePublicIPAddress -IPConfigurationName -Name + -NetworkInterfaceInputObject [-Expand ] [-DefaultProfile ] + [] +``` + +### GetViaIdentityRoleInstance +``` +Get-AzCloudServicePublicIPAddress -IPConfigurationName -Name -NetworkInterfaceName + -RoleInstanceInputObject [-Expand ] [-DefaultProfile ] + [] +``` + ### List1 ``` Get-AzCloudServicePublicIPAddress -CloudServiceName -IPConfigurationName @@ -60,6 +87,21 @@ Gets the instance level public IP addresses for a given cloud service object. ## PARAMETERS +### -CloudServiceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityCloudService +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -CloudServiceName The name of the cloud service. @@ -96,7 +138,7 @@ Expands referenced resources. ```yaml Type: System.String -Parameter Sets: Get, GetViaIdentity +Parameter Sets: Get, GetViaIdentity, GetViaIdentityCloudService, GetViaIdentityIpconfiguration, GetViaIdentityNetworkInterface, GetViaIdentityRoleInstance Aliases: Required: False @@ -108,7 +150,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -122,12 +163,27 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -IpconfigurationInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityIpconfiguration +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -IPConfigurationName The name of the IP configuration. ```yaml Type: System.String -Parameter Sets: Get, List1 +Parameter Sets: Get, GetViaIdentityCloudService, GetViaIdentityNetworkInterface, GetViaIdentityRoleInstance, List1 Aliases: Required: True @@ -142,7 +198,7 @@ The name of the public IP Address. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityCloudService, GetViaIdentityIpconfiguration, GetViaIdentityNetworkInterface, GetViaIdentityRoleInstance Aliases: PublicIPAddressName Required: True @@ -152,12 +208,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -NetworkInterfaceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityNetworkInterface +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -NetworkInterfaceName The name of the network interface. ```yaml Type: System.String -Parameter Sets: Get, List1 +Parameter Sets: Get, GetViaIdentityCloudService, GetViaIdentityRoleInstance, List1 Aliases: Required: True @@ -182,12 +253,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName The role instance name. ```yaml Type: System.String -Parameter Sets: Get, List1 +Parameter Sets: Get, GetViaIdentityCloudService, List1 Aliases: Required: True @@ -222,7 +308,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.IPublicIPAddress +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IPublicIPAddress ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstance.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstance.md index c58c32568f11..ee1cb379cd1a 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstance.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstance.md @@ -15,22 +15,28 @@ Gets a role instance from a cloud service. ### List (Default) ``` Get-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName - [-SubscriptionId ] [-Expand ] [-DefaultProfile ] [] + [-SubscriptionId ] [-Expand ] [-DefaultProfile ] [] ``` ### Get ``` Get-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName - -RoleInstanceName [-SubscriptionId ] [-Expand ] - [-DefaultProfile ] [] + -RoleInstanceName [-SubscriptionId ] [-Expand ] [-DefaultProfile ] + [] ``` ### GetViaIdentity ``` -Get-AzCloudServiceRoleInstance -InputObject [-Expand ] +Get-AzCloudServiceRoleInstance -InputObject [-Expand ] [-DefaultProfile ] [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceRoleInstance -CloudServiceName -RoleInstanceInputObject + [-Expand ] [-DefaultProfile ] [] +``` + ## DESCRIPTION Gets a role instance from a cloud service. @@ -72,7 +78,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: Get, List +Parameter Sets: Get, GetViaIdentityRoleInstance, List Aliases: Required: True @@ -103,7 +109,7 @@ The expand expression to apply to the operation. 'UserData' is not supported for cloud services. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Support.InstanceViewTypes +Type: System.String Parameter Sets: (All) Aliases: @@ -116,7 +122,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -145,6 +150,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. @@ -185,7 +205,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IRoleInstance +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IRoleInstance ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md index cc96801d521e..6822a1fd78bb 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md @@ -12,12 +12,20 @@ Gets a remote desktop file for a role instance in a cloud service. ## SYNTAX +### Get (Default) ``` Get-AzCloudServiceRoleInstanceRemoteDesktopFile -CloudServiceName -ResourceGroupName -RoleInstanceName -OutFile [-SubscriptionId ] [-DefaultProfile ] [-PassThru] [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceRoleInstanceRemoteDesktopFile -CloudServiceName + -RoleInstanceInputObject -OutFile [-DefaultProfile ] [-PassThru] + [] +``` + ## DESCRIPTION Gets a remote desktop file for a role instance in a cloud service. @@ -98,7 +106,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -108,12 +116,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -129,7 +152,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: False @@ -144,6 +167,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## INPUTS +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity + ## OUTPUTS ### System.Boolean diff --git a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceView.md b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceView.md index 5ecda1ec735b..31c9fec7e45c 100644 --- a/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceView.md +++ b/src/CloudService/CloudService.Autorest/docs/Get-AzCloudServiceRoleInstanceView.md @@ -12,11 +12,18 @@ Retrieves information about the run-time state of a role instance in a cloud ser ## SYNTAX +### Get (Default) ``` Get-AzCloudServiceRoleInstanceView -CloudServiceName -ResourceGroupName -RoleInstanceName [-SubscriptionId ] [-DefaultProfile ] [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceRoleInstanceView -CloudServiceName -RoleInstanceInputObject + [-DefaultProfile ] [] +``` + ## DESCRIPTION Retrieves information about the run-time state of a role instance in a cloud service. @@ -73,7 +80,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -83,12 +90,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -104,7 +126,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: False @@ -119,9 +141,11 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## INPUTS +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity + ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IRoleInstanceView +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IRoleInstanceView ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md index 99b9849beb60..d2f0d436cfb3 100644 --- a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md +++ b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md @@ -15,17 +15,31 @@ If you do not want to initialize storage resources, you can use Reimage Role Ins ### RebuildExpanded (Default) ``` -Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName -RoleInstance - [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] +Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] + [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` ### RebuildViaIdentityExpanded ``` -Invoke-AzCloudServiceRebuild -InputObject -RoleInstance +Invoke-AzCloudServiceRebuild -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` +### RebuildViaJsonFilePath +``` +Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName -JsonFilePath + [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] + [] +``` + +### RebuildViaJsonString +``` +Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName -JsonString + [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] + [] +``` + ## DESCRIPTION Rebuild Role Instances reinstalls the operating system on instances of web roles or worker roles and initializes the storage resources that are used by them. If you do not want to initialize storage resources, you can use Reimage Role Instances. @@ -69,7 +83,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: RebuildExpanded +Parameter Sets: RebuildExpanded, RebuildViaJsonFilePath, RebuildViaJsonString Aliases: Required: True @@ -97,7 +111,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -111,6 +124,36 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Rebuild operation + +```yaml +Type: System.String +Parameter Sets: RebuildViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Rebuild operation + +```yaml +Type: System.String +Parameter Sets: RebuildViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -NoWait Run the command asynchronously @@ -146,7 +189,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: RebuildExpanded +Parameter Sets: RebuildExpanded, RebuildViaJsonFilePath, RebuildViaJsonString Aliases: Required: True @@ -162,10 +205,10 @@ Value of '*' will signify all role instances of the cloud service. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: RebuildExpanded, RebuildViaIdentityExpanded Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False @@ -178,7 +221,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String -Parameter Sets: RebuildExpanded +Parameter Sets: RebuildExpanded, RebuildViaJsonFilePath, RebuildViaJsonString Aliases: Required: False diff --git a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceReimage.md b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceReimage.md index 33b284721005..3e0ca5721bee 100644 --- a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceReimage.md +++ b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceReimage.md @@ -14,14 +14,14 @@ Reimage asynchronous operation reinstalls the operating system on instances of w ### ReimageExpanded (Default) ``` -Invoke-AzCloudServiceReimage -Name -ResourceGroupName -RoleInstance - [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] +Invoke-AzCloudServiceReimage -Name -ResourceGroupName [-SubscriptionId ] + [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` ### ReimageViaIdentityExpanded ``` -Invoke-AzCloudServiceReimage -InputObject -RoleInstance +Invoke-AzCloudServiceReimage -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` @@ -80,7 +80,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -163,7 +162,7 @@ Type: System.String[] Parameter Sets: (All) Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False diff --git a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceRebuild.md b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceRebuild.md index 4b1235294551..96b942819999 100644 --- a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceRebuild.md +++ b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceRebuild.md @@ -89,7 +89,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceReimage.md b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceReimage.md index 77c8e707ab10..034dd1fe8a05 100644 --- a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceReimage.md +++ b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRoleInstanceReimage.md @@ -87,7 +87,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudService.md index 64e152ca01b3..2ea89f46320e 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudService.md @@ -8,18 +8,31 @@ schema: 2.0.0 # New-AzCloudService ## SYNOPSIS -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. ## SYNTAX ### CreateExpanded (Default) ``` -New-AzCloudService -Name -ResourceGroupName -Location [-SubscriptionId ] - [-AllowModelOverride] [-Configuration ] [-ConfigurationUrl ] - [-ExtensionProfile ] [-NetworkProfile ] - [-OSProfile ] [-PackageUrl ] [-RoleProfile ] - [-StartCloudService] [-Tag ] [-UpgradeMode ] [-Zone ] +New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] [-AllowModelOverride] + [-Configuration ] [-ConfigurationUrl ] [-ExtensionProfile ] + [-Location ] [-NetworkProfile ] [-OSProfile ] + [-PackageUrl ] [-RoleProfile ] [-StartCloudService] [-Tag ] + [-UpgradeMode ] [-Zone ] [-DefaultProfile ] [-AsJob] [-NoWait] [-Confirm] + [-WhatIf] [] +``` + +### CreateViaJsonFilePath +``` +New-AzCloudService -Name -ResourceGroupName -JsonFilePath + [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-Confirm] [-WhatIf] + [] +``` + +### CreateViaJsonString +``` +New-AzCloudService -Name -ResourceGroupName -JsonString [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-Confirm] [-WhatIf] [] ``` @@ -28,8 +41,7 @@ New-AzCloudService -Name -ResourceGroupName -Location New-AzCloudService -Name -ResourceGroupName -ConfigurationFile -DefinitionFile -Location -PackageUrl [-SubscriptionId ] [-DnsName ] [-ExtensionProfile ] [-KeyVaultName ] - [-StartCloudService] [-Tag ] [-UpgradeMode ] [-Confirm] [-WhatIf] - [] + [-StartCloudService] [-Tag ] [-UpgradeMode ] [-Confirm] [-WhatIf] [] ``` ### quickCreateParameterSetWithStorage @@ -37,12 +49,12 @@ New-AzCloudService -Name -ResourceGroupName -ConfigurationFile New-AzCloudService -Name -ResourceGroupName -ConfigurationFile -DefinitionFile -Location -PackageFile -StorageAccount [-SubscriptionId ] [-DnsName ] [-ExtensionProfile ] - [-KeyVaultName ] [-StartCloudService] [-Tag ] [-UpgradeMode ] - [-Confirm] [-WhatIf] [] + [-KeyVaultName ] [-StartCloudService] [-Tag ] [-UpgradeMode ] [-Confirm] [-WhatIf] + [] ``` ## DESCRIPTION -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. ## EXAMPLES @@ -266,7 +278,7 @@ Run the command as a job ```yaml Type: System.Management.Automation.SwitchParameter -Parameter Sets: CreateExpanded +Parameter Sets: CreateExpanded, CreateViaJsonFilePath, CreateViaJsonString Aliases: Required: False @@ -328,7 +340,7 @@ Use the SubscriptionId parameter when available if executing the cmdlet against ```yaml Type: System.Management.Automation.PSObject -Parameter Sets: CreateExpanded +Parameter Sets: CreateExpanded, CreateViaJsonFilePath, CreateViaJsonString Aliases: AzureRMContext, AzureCredential Required: False @@ -370,11 +382,10 @@ Accept wildcard characters: False ### -ExtensionProfile Describes a cloud service extension profile. -To construct, see NOTES section for EXTENSIONPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceExtensionProfile -Parameter Sets: (All) +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceExtensionProfile +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -384,6 +395,36 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Create operation + +```yaml +Type: System.String +Parameter Sets: CreateViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Create operation + +```yaml +Type: System.String +Parameter Sets: CreateViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -KeyVaultName Name of the KeyVault to be used for the CloudService resource. @@ -404,7 +445,7 @@ Resource location. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: True @@ -431,10 +472,9 @@ Accept wildcard characters: False ### -NetworkProfile Network Profile for the cloud service. -To construct, see NOTES section for NETWORKPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceNetworkProfile +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceNetworkProfile Parameter Sets: CreateExpanded Aliases: @@ -450,7 +490,7 @@ Run the command asynchronously ```yaml Type: System.Management.Automation.SwitchParameter -Parameter Sets: CreateExpanded +Parameter Sets: CreateExpanded, CreateViaJsonFilePath, CreateViaJsonString Aliases: Required: False @@ -462,10 +502,9 @@ Accept wildcard characters: False ### -OSProfile Describes the OS profile for the cloud service. -To construct, see NOTES section for OSPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceOSProfile +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceOSProfile Parameter Sets: CreateExpanded Aliases: @@ -525,10 +564,9 @@ Accept wildcard characters: False ### -RoleProfile Describes the role profile for the cloud service. -To construct, see NOTES section for ROLEPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceRoleProfile +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceRoleProfile Parameter Sets: CreateExpanded Aliases: @@ -547,7 +585,7 @@ A deployed service still incurs charges, even if it is poweredoff. ```yaml Type: System.Management.Automation.SwitchParameter -Parameter Sets: (All) +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -593,7 +631,7 @@ Resource tags. ```yaml Type: System.Collections.Hashtable -Parameter Sets: (All) +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -611,8 +649,8 @@ If set to Manual, PUT UpdateDomain must be called to apply the update. If set to Auto, the update is automatically applied to each update domain in sequence. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Support.CloudServiceUpgradeMode -Parameter Sets: (All) +Type: System.String +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -677,7 +715,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudService +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudService ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md index 24f1217e350f..879328556eef 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md @@ -24,15 +24,27 @@ Create a in-memory object for Diagnostics Extension ## EXAMPLES -### Example 1: Create diagnostics extension object +### Example 1: {{ Add title here }} ```powershell -$storageAccountKey = Get-AzStorageAccountKey -ResourceGroupName "ContosOrg" -Name "ContosSA" -$configFile = "" -$extension = New-AzCloudServiceDiagnosticsExtension -Name "WADExtension" -ResourceGroupName "ContosOrg" -CloudServiceName "ContosCS" -StorageAccountName "ContosSA" -StorageAccountKey $storageAccountKey[0].Value -DiagnosticsConfigurationPath $configFile -TypeHandlerVersion "1.5" -AutoUpgradeMinorVersion $true +{{ Add code here }} ``` -This command creates diagnostics extension object which is used for creating or updating a cloud service. -For more details see New-AzCloudService. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} + +### Example 2: {{ Add title here }} +```powershell +{{ Add code here }} +``` + +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} ## PARAMETERS @@ -194,7 +206,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceExtensionObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceExtensionObject.md index 0ce30e1a4ac3..195815efae53 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceExtensionObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceExtensionObject.md @@ -1,25 +1,26 @@ --- external help file: Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceextensionobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceextensionobject schema: 2.0.0 --- # New-AzCloudServiceExtensionObject ## SYNOPSIS -Create a in-memory object for Extension +Create an in-memory object for Extension. ## SYNTAX ``` -New-AzCloudServiceExtensionObject [-AutoUpgradeMinorVersion ] [-Name ] - [-ProtectedSetting ] [-Publisher ] [-RolesAppliedTo ] [-Setting ] +New-AzCloudServiceExtensionObject [-AutoUpgradeMinorVersion ] [-ForceUpdateTag ] + [-Name ] [-ProtectedSetting ] [-ProtectedSettingFromKeyVaultSecretUrl ] + [-Publisher ] [-RolesAppliedTo ] [-Setting ] [-SourceVaultId ] [-Type ] [-TypeHandlerVersion ] [] ``` ## DESCRIPTION -Create a in-memory object for Extension +Create an in-memory object for Extension. ## EXAMPLES @@ -34,7 +35,7 @@ For more details see New-AzCloudService. ## PARAMETERS ### -AutoUpgradeMinorVersion -Explicitly specify whether CRP can automatically upgrade typeHandlerVersion to higher minor versions when they become available. +Explicitly specify whether platform can automatically upgrade typeHandlerVersion to higher minor versions when they become available. ```yaml Type: System.Boolean @@ -48,8 +49,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -ForceUpdateTag +Tag to force apply the provided public and protected settings. + Changing the tag value allows for re-running the extension without changing any of the public or protected settings. + If forceUpdateTag is not changed, updates to public or protected settings would still be applied by the handler. + If neither forceUpdateTag nor any of public or protected settings change, extension would flow to the role instance with the same sequence-number, and + it is up to handler implementation whether to re-run it or not. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Name -Name. +The name of the extension. ```yaml Type: System.String @@ -64,7 +84,22 @@ Accept wildcard characters: False ``` ### -ProtectedSetting -Protected settings for the extension which are encrypted before sent to the VM. +Protected settings for the extension which are encrypted before sent to the role instance. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProtectedSettingFromKeyVaultSecretUrl +Secret URL which contains the protected settings of the extension. ```yaml Type: System.String @@ -79,7 +114,7 @@ Accept wildcard characters: False ``` ### -Publisher -Publisher. +The name of the extension handler publisher. ```yaml Type: System.String @@ -94,7 +129,8 @@ Accept wildcard characters: False ``` ### -RolesAppliedTo -RolesAppliedTo. +Optional list of roles to apply this extension. +If property is not specified or '*' is specified, extension is applied to all roles in the cloud service. ```yaml Type: System.String[] @@ -110,6 +146,23 @@ Accept wildcard characters: False ### -Setting Public settings for the extension. +For JSON extensions, this is the JSON settings for the extension. +For XML Extension (like RDP), this is the XML setting for the extension. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SourceVaultId +Resource Id. ```yaml Type: System.String @@ -124,7 +177,7 @@ Accept wildcard characters: False ``` ### -Type -Type. +Specifies the type of the extension. ```yaml Type: System.String @@ -139,7 +192,12 @@ Accept wildcard characters: False ``` ### -TypeHandlerVersion -TypeHandlerVersion. +Specifies the version of the extension. +Specifies the version of the extension. +If this element is not specified or an asterisk (*) is used as the value, the latest version of the extension is used. +If the value is specified with a major version number and an asterisk as the minor version number (X.), the latest minor version of the specified major version is selected. +If a major version number and a minor version number are specified (X.Y), the specific extension version is selected. +If a version is specified, an auto-upgrade is performed on the role instance. ```yaml Type: System.String @@ -160,7 +218,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerConfigurationObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerConfigurationObject.md index bc7f1530e410..090ebef91988 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerConfigurationObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerConfigurationObject.md @@ -1,24 +1,25 @@ --- external help file: Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceloadbalancerconfigurationobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceloadbalancerconfigurationobject schema: 2.0.0 --- # New-AzCloudServiceLoadBalancerConfigurationObject ## SYNOPSIS -Create a in-memory object for LoadBalancerConfiguration +Create an in-memory object for LoadBalancerConfiguration. ## SYNTAX ``` New-AzCloudServiceLoadBalancerConfigurationObject - [-FrontendIPConfiguration ] [-Name ] [] + -FrontendIPConfiguration -Name [-Id ] + [] ``` ## DESCRIPTION -Create a in-memory object for LoadBalancerConfiguration +Create an in-memory object for LoadBalancerConfiguration. ## EXAMPLES @@ -35,11 +36,27 @@ For more details see New-AzCloudService. ## PARAMETERS ### -FrontendIPConfiguration -FrontendIPConfiguration. -To construct, see NOTES section for FRONTENDIPCONFIGURATION properties and create a hash table. +Specifies the frontend IP to be used for the load balancer. +Only IPv4 frontend IP address is supported. +Each load balancer configuration must have exactly one frontend IP configuration. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ILoadBalancerFrontendIPConfiguration[] +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ILoadBalancerFrontendIPConfiguration[] +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Id +Resource Id. + +```yaml +Type: System.String Parameter Sets: (All) Aliases: @@ -51,14 +68,14 @@ Accept wildcard characters: False ``` ### -Name -Name of LoadBalancerConfiguration. +The name of the Load balancer. ```yaml Type: System.String Parameter Sets: (All) Aliases: -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False @@ -72,7 +89,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerConfiguration +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerConfiguration ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md index 3094d762c0ef..726c1dfcaf31 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md @@ -1,66 +1,68 @@ --- external help file: Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceloadbalancerfrontendipconfigurationobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceloadbalancerfrontendipconfigurationobject schema: 2.0.0 --- # New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject ## SYNOPSIS -Create a in-memory object for LoadBalancerFrontendIPConfiguration +Create an in-memory object for LoadBalancerFrontendIPConfiguration. ## SYNTAX ### DefaultParameterSet (Default) ``` -New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject [-Name ] [-PublicIPAddressId ] +New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name [-PublicIPAddressId ] [] ``` ### PrivateIP ``` -New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject [-Name ] [-PrivateIPAddress ] +New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name [-PrivateIPAddress ] [-SubnetId ] [] ``` ## DESCRIPTION -Create a in-memory object for LoadBalancerFrontendIPConfiguration +Create an in-memory object for LoadBalancerFrontendIPConfiguration. ## EXAMPLES -### Example 1: Create load balancer frontend IP configuration object +### Example 1: {{ Add title here }} ```powershell -$publicIP = Get-AzPublicIpAddress -ResourceGroupName 'ContosoOrg' -Name 'ContosoPublicIP' -$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -PublicIPAddressId $publicIp.Id -$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig +{{ Add code here }} ``` -This command creates load balancer frontend IP configuration object which is used for creating or updating a cloud service. -For more details see New-AzCloudService. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} -### Example 2: Create load balancer frontend IP configuration object with Private ID address +### Example 2: {{ Add title here }} ```powershell -# Create role profile object -$subnet = New-AzVirtualNetworkSubnetConfig -Name "WebTier" -AddressPrefix "10.0.0.0/24" -WarningAction SilentlyContinue -$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -privateIPAddress '10.0.0.6' -subnetId $Subnet.Id -$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig +{{ Add code here }} +``` +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} ``` -This command creates load balancer frontend IP configuration object with a Private IP address +{{ Add description here }} ## PARAMETERS ### -Name -Name of FrontendIpConfiguration. +The name of the resource that is unique within the set of frontend IP configurations used by the load balancer. +This name can be used to access the resource. ```yaml Type: System.String Parameter Sets: (All) Aliases: -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False @@ -68,7 +70,7 @@ Accept wildcard characters: False ``` ### -PrivateIPAddress -Private IP Address +The virtual network private IP address of the IP configuration. ```yaml Type: System.String @@ -98,7 +100,7 @@ Accept wildcard characters: False ``` ### -SubnetId -Subnet ID +Resource Id. ```yaml Type: System.String @@ -119,7 +121,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerFrontendIPConfiguration +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerFrontendIPConfiguration ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md index 98b816f62dcd..bf4e25f0ffae 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md @@ -23,15 +23,27 @@ Create a in-memory object for Remote Desktop Extension ## EXAMPLES -### Example 1: Create remote desktop extension object +### Example 1: {{ Add title here }} ```powershell -$credential = Get-Credential -$expiration = (Get-Date).AddYears(1) -$extension = New-AzCloudServiceRemoteDesktopExtensionObject -Name 'RDPExtension' -Credential $credential -Expiration $expiration -TypeHandlerVersion '1.2.1' +{{ Add code here }} ``` -This command creates remote desktop extension object which is used for creating or updating a cloud service. -For more details see New-AzCloudService. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} + +### Example 2: {{ Add title here }} +```powershell +{{ Add code here }} +``` + +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} ## PARAMETERS @@ -132,7 +144,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRoleProfilePropertiesObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRoleProfilePropertiesObject.md index 9a23a53c5b0b..9d066bde190d 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRoleProfilePropertiesObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRoleProfilePropertiesObject.md @@ -1,14 +1,14 @@ --- external help file: Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceroleprofilepropertiesobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceroleprofilepropertiesobject schema: 2.0.0 --- # New-AzCloudServiceRoleProfilePropertiesObject ## SYNOPSIS -Create a in-memory object for CloudServiceRoleProfileProperties +Create an in-memory object for CloudServiceRoleProfileProperties. ## SYNTAX @@ -18,7 +18,7 @@ New-AzCloudServiceRoleProfilePropertiesObject [-Name ] [-SkuCapacity \
**Standard** \
\
**Basic**. ```yaml Type: System.String @@ -99,7 +101,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudServiceRoleProfileProperties +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceRoleProfileProperties ## NOTES diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md index 28fb131af869..138fcc95c807 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md @@ -1,14 +1,14 @@ --- external help file: Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudservicevaultsecretgroupobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudservicevaultsecretgroupobject schema: 2.0.0 --- # New-AzCloudServiceVaultSecretGroupObject ## SYNOPSIS -Create a in-memory object for Vault Secret Group +Create an in-memory object for CloudServiceVaultSecretGroup. ## SYNTAX @@ -17,19 +17,31 @@ New-AzCloudServiceVaultSecretGroupObject [-CertificateUrl ] [-Id -ResourceGroupName - -RoleInstance [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] + [-SubscriptionId ] [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` ### DeleteViaIdentityExpanded ``` -Remove-AzCloudServiceRoleInstance -InputObject -RoleInstance +Remove-AzCloudServiceRoleInstance -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` +### DeleteViaJsonFilePath +``` +Remove-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName + -JsonFilePath [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-Confirm] [-WhatIf] [] +``` + +### DeleteViaJsonString +``` +Remove-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName -JsonString + [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] + [] +``` + ## DESCRIPTION Deletes role instances in a cloud service. @@ -59,7 +73,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: DeleteExpanded +Parameter Sets: DeleteExpanded, DeleteViaJsonFilePath, DeleteViaJsonString Aliases: Required: True @@ -87,7 +101,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -101,6 +114,36 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Delete operation + +```yaml +Type: System.String +Parameter Sets: DeleteViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Delete operation + +```yaml +Type: System.String +Parameter Sets: DeleteViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -NoWait Run the command asynchronously @@ -136,7 +179,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: DeleteExpanded +Parameter Sets: DeleteExpanded, DeleteViaJsonFilePath, DeleteViaJsonString Aliases: Required: True @@ -152,10 +195,10 @@ Value of '*' will signify all role instances of the cloud service. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: DeleteExpanded, DeleteViaIdentityExpanded Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False @@ -168,7 +211,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String -Parameter Sets: DeleteExpanded +Parameter Sets: DeleteExpanded, DeleteViaJsonFilePath, DeleteViaJsonString Aliases: Required: False diff --git a/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudService.md index 9d3b333846e4..4f9e25b8d408 100644 --- a/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudService.md @@ -14,17 +14,31 @@ Restarts one or more role instances in a cloud service. ### RestartExpanded (Default) ``` -Restart-AzCloudService -Name -ResourceGroupName -RoleInstance - [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] +Restart-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] + [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` ### RestartViaIdentityExpanded ``` -Restart-AzCloudService -InputObject -RoleInstance +Restart-AzCloudService -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` +### RestartViaJsonFilePath +``` +Restart-AzCloudService -Name -ResourceGroupName -JsonFilePath + [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] + [] +``` + +### RestartViaJsonString +``` +Restart-AzCloudService -Name -ResourceGroupName -JsonString + [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] + [] +``` + ## DESCRIPTION Restarts one or more role instances in a cloud service. @@ -80,7 +94,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -94,12 +107,42 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Restart operation + +```yaml +Type: System.String +Parameter Sets: RestartViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Restart operation + +```yaml +Type: System.String +Parameter Sets: RestartViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Name Name of the cloud service. ```yaml Type: System.String -Parameter Sets: RestartExpanded +Parameter Sets: RestartExpanded, RestartViaJsonFilePath, RestartViaJsonString Aliases: CloudServiceName Required: True @@ -144,7 +187,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: RestartExpanded +Parameter Sets: RestartExpanded, RestartViaJsonFilePath, RestartViaJsonString Aliases: Required: True @@ -160,10 +203,10 @@ Value of '*' will signify all role instances of the cloud service. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: RestartExpanded, RestartViaIdentityExpanded Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False @@ -176,7 +219,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String -Parameter Sets: RestartExpanded +Parameter Sets: RestartExpanded, RestartViaJsonFilePath, RestartViaJsonString Aliases: Required: False diff --git a/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudServiceRoleInstance.md b/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudServiceRoleInstance.md index 78acc47779c9..dd2e09173325 100644 --- a/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudServiceRoleInstance.md +++ b/src/CloudService/CloudService.Autorest/docs/Restart-AzCloudServiceRoleInstance.md @@ -25,6 +25,12 @@ Restart-AzCloudServiceRoleInstance -InputObject [-Defaul [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` +### RestartViaIdentityRoleInstance +``` +Restart-AzCloudServiceRoleInstance -CloudServiceName -RoleInstanceInputObject + [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] +``` + ## DESCRIPTION The Reboot Role Instance asynchronous operation requests a reboot of a role instance in the cloud service. @@ -59,7 +65,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: Restart +Parameter Sets: Restart, RestartViaIdentityRoleInstance Aliases: Required: True @@ -87,7 +93,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -146,6 +151,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: RestartViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. diff --git a/src/CloudService/CloudService.Autorest/docs/Set-AzCloudServiceUpdateDomain.md b/src/CloudService/CloudService.Autorest/docs/Set-AzCloudServiceUpdateDomain.md index cd6f1dba9a79..899c9ccfb51a 100644 --- a/src/CloudService/CloudService.Autorest/docs/Set-AzCloudServiceUpdateDomain.md +++ b/src/CloudService/CloudService.Autorest/docs/Set-AzCloudServiceUpdateDomain.md @@ -8,18 +8,33 @@ schema: 2.0.0 # Set-AzCloudServiceUpdateDomain ## SYNOPSIS -Updates the role instances in the specified update domain. +Walk the role instances in the specified walk domain. ## SYNTAX +### WalkExpanded (Default) ``` Set-AzCloudServiceUpdateDomain -CloudServiceName -ResourceGroupName -UpdateDomain [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` +### WalkViaJsonFilePath +``` +Set-AzCloudServiceUpdateDomain -CloudServiceName -ResourceGroupName -UpdateDomain + -JsonFilePath [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-Confirm] [-WhatIf] [] +``` + +### WalkViaJsonString +``` +Set-AzCloudServiceUpdateDomain -CloudServiceName -ResourceGroupName -UpdateDomain + -JsonString [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-Confirm] [-WhatIf] [] +``` + ## DESCRIPTION -Updates the role instances in the specified update domain. +Walk the role instances in the specified walk domain. ## EXAMPLES @@ -78,6 +93,36 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Walk operation + +```yaml +Type: System.String +Parameter Sets: WalkViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Walk operation + +```yaml +Type: System.String +Parameter Sets: WalkViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -NoWait Run the command asynchronously diff --git a/src/CloudService/CloudService.Autorest/docs/Start-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/Start-AzCloudService.md index 85a97b6ec40f..2f8b8913793f 100644 --- a/src/CloudService/CloudService.Autorest/docs/Start-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Start-AzCloudService.md @@ -71,7 +71,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService.Autorest/docs/Stop-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/Stop-AzCloudService.md index bab77082a692..0745520854d5 100644 --- a/src/CloudService/CloudService.Autorest/docs/Stop-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Stop-AzCloudService.md @@ -73,7 +73,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md index 1256c4323647..fdb94bf2acf4 100644 --- a/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md @@ -29,22 +29,27 @@ Swaps VIPs between two cloud service (extended support) load balancers. ## EXAMPLES -### Example 1: Switch cloud service using name +### Example 1: {{ Add title here }} ```powershell -Switch-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca +{{ Add code here }} ``` -Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. -'BService' with be swapped with its swappable cloud service. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} -### Example 2: Switch cloud service using cloud service object +### Example 2: {{ Add title here }} ```powershell -$cs = Get-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca -Switch-AzCloudService -CloudService $cs +{{ Add code here }} ``` -Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. -'BService' with be swapped with its swappable cloud service. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} ## PARAMETERS @@ -79,10 +84,10 @@ Accept wildcard characters: False ``` ### -CloudService -To construct, see NOTES section for CLOUDSERVICE properties and create a hash table. + ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudService +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudService Parameter Sets: CloudService Aliases: diff --git a/src/CloudService/CloudService.Autorest/docs/Update-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/Update-AzCloudService.md index eb810a96159e..3f5984dc4490 100644 --- a/src/CloudService/CloudService.Autorest/docs/Update-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Update-AzCloudService.md @@ -8,7 +8,7 @@ schema: 2.0.0 # Update-AzCloudService ## SYNOPSIS -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. ## SYNTAX @@ -19,7 +19,7 @@ Update-AzCloudService -InputObject -Parameter -Name -Re [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceNetworkInterface -Name -RoleInstanceInputObject + [-Expand ] [-DefaultProfile ] [] +``` + +### GetViaIdentityCloudService +``` +Get-AzCloudServiceNetworkInterface -Name -RoleInstanceName + -CloudServiceInputObject [-Expand ] [-DefaultProfile ] + [] +``` + ### GetViaIdentity ``` Get-AzCloudServiceNetworkInterface -InputObject [-Expand ] @@ -61,6 +74,21 @@ Gets all the network interfaces for a given cloud service object. ## PARAMETERS +### -CloudServiceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityCloudService +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -CloudServiceName The name of the cloud service. @@ -97,7 +125,7 @@ Expands referenced resources. ```yaml Type: System.String -Parameter Sets: Get, GetViaIdentity +Parameter Sets: Get, GetViaIdentityRoleInstance, GetViaIdentityCloudService, GetViaIdentity Aliases: Required: False @@ -109,7 +137,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -128,7 +155,7 @@ The name of the network interface. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityRoleInstance, GetViaIdentityCloudService Aliases: NetworkInterfaceName Required: True @@ -153,12 +180,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName The name of role instance. ```yaml Type: System.String -Parameter Sets: List, Get +Parameter Sets: List, Get, GetViaIdentityCloudService Aliases: Required: True @@ -193,7 +235,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.INetworkInterface +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.INetworkInterface ## NOTES diff --git a/src/CloudService/CloudService/help/Get-AzCloudServiceOSFamily.md b/src/CloudService/CloudService/help/Get-AzCloudServiceOSFamily.md index 1f85ef2f3eda..099058f8a958 100644 --- a/src/CloudService/CloudService/help/Get-AzCloudServiceOSFamily.md +++ b/src/CloudService/CloudService/help/Get-AzCloudServiceOSFamily.md @@ -24,6 +24,12 @@ Get-AzCloudServiceOSFamily -Location -OSFamilyName [-Subscript [-DefaultProfile ] [] ``` +### GetViaIdentityLocation +``` +Get-AzCloudServiceOSFamily -OSFamilyName -LocationInputObject + [-DefaultProfile ] [] +``` + ### GetViaIdentity ``` Get-AzCloudServiceOSFamily -InputObject [-DefaultProfile ] @@ -85,7 +91,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -114,12 +119,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -LocationInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityLocation +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -OSFamilyName Name of the OS family. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityLocation Aliases: Required: True @@ -154,7 +174,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IOSFamily +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IOSFamily ## NOTES diff --git a/src/CloudService/CloudService/help/Get-AzCloudServiceOSVersion.md b/src/CloudService/CloudService/help/Get-AzCloudServiceOSVersion.md index bff3efb863ba..fd02746f4386 100644 --- a/src/CloudService/CloudService/help/Get-AzCloudServiceOSVersion.md +++ b/src/CloudService/CloudService/help/Get-AzCloudServiceOSVersion.md @@ -24,6 +24,12 @@ Get-AzCloudServiceOSVersion -Location -OSVersionName [-Subscri [-DefaultProfile ] [] ``` +### GetViaIdentityLocation +``` +Get-AzCloudServiceOSVersion -OSVersionName -LocationInputObject + [-DefaultProfile ] [] +``` + ### GetViaIdentity ``` Get-AzCloudServiceOSVersion -InputObject [-DefaultProfile ] @@ -85,7 +91,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -114,12 +119,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -LocationInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityLocation +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -OSVersionName Name of the OS version. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityLocation Aliases: Required: True @@ -154,7 +174,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IOSVersion +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IOSVersion ## NOTES diff --git a/src/CloudService/CloudService/help/Get-AzCloudServicePublicIPAddress.md b/src/CloudService/CloudService/help/Get-AzCloudServicePublicIPAddress.md index cd30f04445f9..dca16a0a5688 100644 --- a/src/CloudService/CloudService/help/Get-AzCloudServicePublicIPAddress.md +++ b/src/CloudService/CloudService/help/Get-AzCloudServicePublicIPAddress.md @@ -35,6 +35,33 @@ Get-AzCloudServicePublicIPAddress -CloudServiceName -IPConfigurationNam [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServicePublicIPAddress -IPConfigurationName -Name -NetworkInterfaceName + -RoleInstanceInputObject [-Expand ] [-DefaultProfile ] + [] +``` + +### GetViaIdentityNetworkInterface +``` +Get-AzCloudServicePublicIPAddress -IPConfigurationName -Name + -NetworkInterfaceInputObject [-Expand ] [-DefaultProfile ] + [] +``` + +### GetViaIdentityCloudService +``` +Get-AzCloudServicePublicIPAddress -IPConfigurationName -Name -NetworkInterfaceName + -RoleInstanceName -CloudServiceInputObject [-Expand ] + [-DefaultProfile ] [] +``` + +### GetViaIdentityIpconfiguration +``` +Get-AzCloudServicePublicIPAddress -Name -IpconfigurationInputObject + [-Expand ] [-DefaultProfile ] [] +``` + ### GetViaIdentity ``` Get-AzCloudServicePublicIPAddress -InputObject [-Expand ] @@ -63,6 +90,21 @@ Gets the instance level public IP addresses for a given cloud service object. ## PARAMETERS +### -CloudServiceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityCloudService +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -CloudServiceName The name of the cloud service. @@ -99,7 +141,7 @@ Expands referenced resources. ```yaml Type: System.String -Parameter Sets: Get, GetViaIdentity +Parameter Sets: Get, GetViaIdentityRoleInstance, GetViaIdentityNetworkInterface, GetViaIdentityCloudService, GetViaIdentityIpconfiguration, GetViaIdentity Aliases: Required: False @@ -111,7 +153,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -125,12 +166,27 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -IpconfigurationInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityIpconfiguration +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -IPConfigurationName The name of the IP configuration. ```yaml Type: System.String -Parameter Sets: List1, Get +Parameter Sets: List1, Get, GetViaIdentityRoleInstance, GetViaIdentityNetworkInterface, GetViaIdentityCloudService Aliases: Required: True @@ -145,7 +201,7 @@ The name of the public IP Address. ```yaml Type: System.String -Parameter Sets: Get +Parameter Sets: Get, GetViaIdentityRoleInstance, GetViaIdentityNetworkInterface, GetViaIdentityCloudService, GetViaIdentityIpconfiguration Aliases: PublicIPAddressName Required: True @@ -155,12 +211,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -NetworkInterfaceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityNetworkInterface +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -NetworkInterfaceName The name of the network interface. ```yaml Type: System.String -Parameter Sets: List1, Get +Parameter Sets: List1, Get, GetViaIdentityRoleInstance, GetViaIdentityCloudService Aliases: Required: True @@ -185,12 +256,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName The role instance name. ```yaml Type: System.String -Parameter Sets: List1, Get +Parameter Sets: List1, Get, GetViaIdentityCloudService Aliases: Required: True @@ -225,7 +311,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20210301.IPublicIPAddress +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IPublicIPAddress ## NOTES diff --git a/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstance.md b/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstance.md index 83d1a2be826d..e8dfea4d9957 100644 --- a/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstance.md +++ b/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstance.md @@ -15,20 +15,26 @@ Gets a role instance from a cloud service. ### List (Default) ``` Get-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName - [-SubscriptionId ] [-Expand ] [-DefaultProfile ] + [-SubscriptionId ] [-Expand ] [-DefaultProfile ] [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceRoleInstance -CloudServiceName -RoleInstanceInputObject + [-Expand ] [-DefaultProfile ] [] +``` + ### Get ``` Get-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName - -RoleInstanceName [-SubscriptionId ] [-Expand ] - [-DefaultProfile ] [] + -RoleInstanceName [-SubscriptionId ] [-Expand ] [-DefaultProfile ] + [] ``` ### GetViaIdentity ``` -Get-AzCloudServiceRoleInstance -InputObject [-Expand ] +Get-AzCloudServiceRoleInstance -InputObject [-Expand ] [-DefaultProfile ] [] ``` @@ -73,7 +79,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: List, Get +Parameter Sets: List, GetViaIdentityRoleInstance, Get Aliases: Required: True @@ -104,7 +110,7 @@ The expand expression to apply to the operation. 'UserData' is not supported for cloud services. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Support.InstanceViewTypes +Type: System.String Parameter Sets: (All) Aliases: @@ -117,7 +123,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -146,6 +151,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. @@ -186,7 +206,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IRoleInstance +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IRoleInstance ## NOTES diff --git a/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md b/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md index 4e4a1e045c4c..36264c5262bc 100644 --- a/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md +++ b/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceRemoteDesktopFile.md @@ -12,12 +12,20 @@ Gets a remote desktop file for a role instance in a cloud service. ## SYNTAX +### Get (Default) ``` Get-AzCloudServiceRoleInstanceRemoteDesktopFile -CloudServiceName -ResourceGroupName -RoleInstanceName [-SubscriptionId ] -OutFile [-DefaultProfile ] [-PassThru] [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceRoleInstanceRemoteDesktopFile -CloudServiceName + -RoleInstanceInputObject -OutFile [-DefaultProfile ] [-PassThru] + [] +``` + ## DESCRIPTION Gets a remote desktop file for a role instance in a cloud service. @@ -98,7 +106,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -108,12 +116,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -129,7 +152,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: False @@ -144,6 +167,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## INPUTS +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity + ## OUTPUTS ### System.Boolean diff --git a/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceView.md b/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceView.md index 8d7e16f91486..c327a3b13dc6 100644 --- a/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceView.md +++ b/src/CloudService/CloudService/help/Get-AzCloudServiceRoleInstanceView.md @@ -12,12 +12,19 @@ Retrieves information about the run-time state of a role instance in a cloud ser ## SYNTAX +### Get (Default) ``` Get-AzCloudServiceRoleInstanceView -CloudServiceName -ResourceGroupName -RoleInstanceName [-SubscriptionId ] [-DefaultProfile ] [] ``` +### GetViaIdentityRoleInstance +``` +Get-AzCloudServiceRoleInstanceView -CloudServiceName -RoleInstanceInputObject + [-DefaultProfile ] [] +``` + ## DESCRIPTION Retrieves information about the run-time state of a role instance in a cloud service. @@ -74,7 +81,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -84,12 +91,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: GetViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: True @@ -105,7 +127,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: Get Aliases: Required: False @@ -120,9 +142,11 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## INPUTS +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity + ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.IRoleInstanceView +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.IRoleInstanceView ## NOTES diff --git a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md index 00470532b8dd..51c14c20f864 100644 --- a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md +++ b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md @@ -16,13 +16,27 @@ If you do not want to initialize storage resources, you can use Reimage Role Ins ### RebuildExpanded (Default) ``` Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] - -RoleInstance [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + +### RebuildViaJsonString +``` +Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] + -JsonString [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + +### RebuildViaJsonFilePath +``` +Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] + -JsonFilePath [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` ### RebuildViaIdentityExpanded ``` -Invoke-AzCloudServiceRebuild -InputObject -RoleInstance +Invoke-AzCloudServiceRebuild -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` @@ -70,7 +84,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: RebuildExpanded +Parameter Sets: RebuildExpanded, RebuildViaJsonString, RebuildViaJsonFilePath Aliases: Required: True @@ -98,7 +112,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -112,6 +125,36 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Rebuild operation + +```yaml +Type: System.String +Parameter Sets: RebuildViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Rebuild operation + +```yaml +Type: System.String +Parameter Sets: RebuildViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -NoWait Run the command asynchronously @@ -147,7 +190,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: RebuildExpanded +Parameter Sets: RebuildExpanded, RebuildViaJsonString, RebuildViaJsonFilePath Aliases: Required: True @@ -163,10 +206,10 @@ Value of '*' will signify all role instances of the cloud service. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: RebuildExpanded, RebuildViaIdentityExpanded Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False @@ -179,7 +222,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String -Parameter Sets: RebuildExpanded +Parameter Sets: RebuildExpanded, RebuildViaJsonString, RebuildViaJsonFilePath Aliases: Required: False diff --git a/src/CloudService/CloudService/help/Invoke-AzCloudServiceReimage.md b/src/CloudService/CloudService/help/Invoke-AzCloudServiceReimage.md index 5262fed4f993..9ca7a7ff41c0 100644 --- a/src/CloudService/CloudService/help/Invoke-AzCloudServiceReimage.md +++ b/src/CloudService/CloudService/help/Invoke-AzCloudServiceReimage.md @@ -15,13 +15,13 @@ Reimage asynchronous operation reinstalls the operating system on instances of w ### ReimageExpanded (Default) ``` Invoke-AzCloudServiceReimage -Name -ResourceGroupName [-SubscriptionId ] - -RoleInstance [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` ### ReimageViaIdentityExpanded ``` -Invoke-AzCloudServiceReimage -InputObject -RoleInstance +Invoke-AzCloudServiceReimage -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` @@ -81,7 +81,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -164,7 +163,7 @@ Type: System.String[] Parameter Sets: (All) Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False diff --git a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceRebuild.md b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceRebuild.md index 32545a33f3dd..8cf550ddee55 100644 --- a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceRebuild.md +++ b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceRebuild.md @@ -89,7 +89,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceReimage.md b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceReimage.md index 0dd7ae59d7e2..0027637f8b09 100644 --- a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceReimage.md +++ b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRoleInstanceReimage.md @@ -87,7 +87,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService/help/New-AzCloudService.md b/src/CloudService/CloudService/help/New-AzCloudService.md index 5032686155a9..c0e507ac0896 100644 --- a/src/CloudService/CloudService/help/New-AzCloudService.md +++ b/src/CloudService/CloudService/help/New-AzCloudService.md @@ -8,42 +8,55 @@ schema: 2.0.0 # New-AzCloudService ## SYNOPSIS -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. ## SYNTAX ### CreateExpanded (Default) ``` -New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] -Location - [-AllowModelOverride] [-Configuration ] [-ConfigurationUrl ] - [-ExtensionProfile ] [-NetworkProfile ] - [-OSProfile ] [-PackageUrl ] [-RoleProfile ] - [-StartCloudService] [-Tag ] [-UpgradeMode ] [-Zone ] - [-DefaultProfile ] [-AsJob] [-NoWait] [-WhatIf] [-Confirm] - [] +New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] [-AllowModelOverride] + [-Configuration ] [-ConfigurationUrl ] [-ExtensionProfile ] + [-Location ] [-NetworkProfile ] [-OSProfile ] + [-PackageUrl ] [-RoleProfile ] [-StartCloudService] [-Tag ] + [-UpgradeMode ] [-Zone ] [-DefaultProfile ] [-AsJob] [-NoWait] + [-WhatIf] [-Confirm] [] ``` ### quickCreateParameterSetWithoutStorage ``` -New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] -Location - [-ExtensionProfile ] -PackageUrl [-StartCloudService] - [-Tag ] [-UpgradeMode ] -ConfigurationFile +New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] + [-ExtensionProfile ] -Location -PackageUrl + [-StartCloudService] [-Tag ] [-UpgradeMode ] -ConfigurationFile -DefinitionFile [-DnsName ] [-KeyVaultName ] [-WhatIf] [-Confirm] [] ``` ### quickCreateParameterSetWithStorage ``` -New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] -Location - [-ExtensionProfile ] [-StartCloudService] [-Tag ] - [-UpgradeMode ] -ConfigurationFile -DefinitionFile - -PackageFile -StorageAccount [-DnsName ] [-KeyVaultName ] +New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] + [-ExtensionProfile ] -Location [-StartCloudService] [-Tag ] + [-UpgradeMode ] -ConfigurationFile -DefinitionFile -PackageFile + -StorageAccount [-DnsName ] [-KeyVaultName ] [-WhatIf] [-Confirm] [] ``` +### CreateViaJsonFilePath +``` +New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] -JsonFilePath + [-DefaultProfile ] [-AsJob] [-NoWait] [-WhatIf] [-Confirm] + [] +``` + +### CreateViaJsonString +``` +New-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] -JsonString + [-DefaultProfile ] [-AsJob] [-NoWait] [-WhatIf] [-Confirm] + [] +``` + ## DESCRIPTION -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. ## EXAMPLES @@ -265,7 +278,7 @@ Run the command as a job ```yaml Type: System.Management.Automation.SwitchParameter -Parameter Sets: CreateExpanded +Parameter Sets: CreateExpanded, CreateViaJsonFilePath, CreateViaJsonString Aliases: Required: False @@ -327,7 +340,7 @@ Use the SubscriptionId parameter when available if executing the cmdlet against ```yaml Type: System.Management.Automation.PSObject -Parameter Sets: CreateExpanded +Parameter Sets: CreateExpanded, CreateViaJsonFilePath, CreateViaJsonString Aliases: AzureRMContext, AzureCredential Required: False @@ -369,11 +382,10 @@ Accept wildcard characters: False ### -ExtensionProfile Describes a cloud service extension profile. -To construct, see NOTES section for EXTENSIONPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceExtensionProfile -Parameter Sets: (All) +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceExtensionProfile +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -383,6 +395,36 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Create operation + +```yaml +Type: System.String +Parameter Sets: CreateViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Create operation + +```yaml +Type: System.String +Parameter Sets: CreateViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -KeyVaultName Name of the KeyVault to be used for the CloudService resource. @@ -403,7 +445,19 @@ Resource location. ```yaml Type: System.String -Parameter Sets: (All) +Parameter Sets: CreateExpanded +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +```yaml +Type: System.String +Parameter Sets: quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: True @@ -430,10 +484,9 @@ Accept wildcard characters: False ### -NetworkProfile Network Profile for the cloud service. -To construct, see NOTES section for NETWORKPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceNetworkProfile +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceNetworkProfile Parameter Sets: CreateExpanded Aliases: @@ -449,7 +502,7 @@ Run the command asynchronously ```yaml Type: System.Management.Automation.SwitchParameter -Parameter Sets: CreateExpanded +Parameter Sets: CreateExpanded, CreateViaJsonFilePath, CreateViaJsonString Aliases: Required: False @@ -461,10 +514,9 @@ Accept wildcard characters: False ### -OSProfile Describes the OS profile for the cloud service. -To construct, see NOTES section for OSPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceOSProfile +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceOSProfile Parameter Sets: CreateExpanded Aliases: @@ -536,10 +588,9 @@ Accept wildcard characters: False ### -RoleProfile Describes the role profile for the cloud service. -To construct, see NOTES section for ROLEPROFILE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudServiceRoleProfile +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceRoleProfile Parameter Sets: CreateExpanded Aliases: @@ -558,7 +609,7 @@ A deployed service still incurs charges, even if it is poweredoff. ```yaml Type: System.Management.Automation.SwitchParameter -Parameter Sets: (All) +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -604,7 +655,7 @@ Resource tags. ```yaml Type: System.Collections.Hashtable -Parameter Sets: (All) +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -622,8 +673,8 @@ If set to Manual, PUT UpdateDomain must be called to apply the update. If set to Auto, the update is automatically applied to each update domain in sequence. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Support.CloudServiceUpgradeMode -Parameter Sets: (All) +Type: System.String +Parameter Sets: CreateExpanded, quickCreateParameterSetWithoutStorage, quickCreateParameterSetWithStorage Aliases: Required: False @@ -688,7 +739,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ICloudService +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudService ## NOTES diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md b/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md index 3a5c1db9b601..5b88781b8289 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md @@ -25,15 +25,27 @@ Create a in-memory object for Diagnostics Extension ## EXAMPLES -### Example 1: Create diagnostics extension object +### Example 1: {{ Add title here }} ```powershell -$storageAccountKey = Get-AzStorageAccountKey -ResourceGroupName "ContosOrg" -Name "ContosSA" -$configFile = "" -$extension = New-AzCloudServiceDiagnosticsExtension -Name "WADExtension" -ResourceGroupName "ContosOrg" -CloudServiceName "ContosCS" -StorageAccountName "ContosSA" -StorageAccountKey $storageAccountKey[0].Value -DiagnosticsConfigurationPath $configFile -TypeHandlerVersion "1.5" -AutoUpgradeMinorVersion $true +{{ Add code here }} ``` -This command creates diagnostics extension object which is used for creating or updating a cloud service. -For more details see New-AzCloudService. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} + +### Example 2: {{ Add title here }} +```powershell +{{ Add code here }} +``` + +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} ## PARAMETERS @@ -195,7 +207,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension ## NOTES diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceExtensionObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceExtensionObject.md index 1240a3dd43db..db19f0230c7f 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceExtensionObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceExtensionObject.md @@ -1,25 +1,26 @@ --- external help file: Az.CloudService-help.xml Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceextensionobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceextensionobject schema: 2.0.0 --- # New-AzCloudServiceExtensionObject ## SYNOPSIS -Create a in-memory object for Extension +Create an in-memory object for Extension. ## SYNTAX ``` -New-AzCloudServiceExtensionObject [-AutoUpgradeMinorVersion ] [-Name ] - [-ProtectedSetting ] [-Publisher ] [-RolesAppliedTo ] [-Setting ] +New-AzCloudServiceExtensionObject [-AutoUpgradeMinorVersion ] [-ForceUpdateTag ] + [-Name ] [-ProtectedSetting ] [-ProtectedSettingFromKeyVaultSecretUrl ] + [-Publisher ] [-RolesAppliedTo ] [-Setting ] [-SourceVaultId ] [-Type ] [-TypeHandlerVersion ] [] ``` ## DESCRIPTION -Create a in-memory object for Extension +Create an in-memory object for Extension. ## EXAMPLES @@ -34,7 +35,7 @@ For more details see New-AzCloudService. ## PARAMETERS ### -AutoUpgradeMinorVersion -Explicitly specify whether CRP can automatically upgrade typeHandlerVersion to higher minor versions when they become available. +Explicitly specify whether platform can automatically upgrade typeHandlerVersion to higher minor versions when they become available. ```yaml Type: System.Boolean @@ -48,8 +49,27 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -ForceUpdateTag +Tag to force apply the provided public and protected settings. + Changing the tag value allows for re-running the extension without changing any of the public or protected settings. + If forceUpdateTag is not changed, updates to public or protected settings would still be applied by the handler. + If neither forceUpdateTag nor any of public or protected settings change, extension would flow to the role instance with the same sequence-number, and + it is up to handler implementation whether to re-run it or not. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Name -Name. +The name of the extension. ```yaml Type: System.String @@ -64,7 +84,22 @@ Accept wildcard characters: False ``` ### -ProtectedSetting -Protected settings for the extension which are encrypted before sent to the VM. +Protected settings for the extension which are encrypted before sent to the role instance. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ProtectedSettingFromKeyVaultSecretUrl +Secret URL which contains the protected settings of the extension. ```yaml Type: System.String @@ -79,7 +114,7 @@ Accept wildcard characters: False ``` ### -Publisher -Publisher. +The name of the extension handler publisher. ```yaml Type: System.String @@ -94,7 +129,8 @@ Accept wildcard characters: False ``` ### -RolesAppliedTo -RolesAppliedTo. +Optional list of roles to apply this extension. +If property is not specified or '*' is specified, extension is applied to all roles in the cloud service. ```yaml Type: System.String[] @@ -110,6 +146,23 @@ Accept wildcard characters: False ### -Setting Public settings for the extension. +For JSON extensions, this is the JSON settings for the extension. +For XML Extension (like RDP), this is the XML setting for the extension. + +```yaml +Type: System.String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SourceVaultId +Resource Id. ```yaml Type: System.String @@ -124,7 +177,7 @@ Accept wildcard characters: False ``` ### -Type -Type. +Specifies the type of the extension. ```yaml Type: System.String @@ -139,7 +192,12 @@ Accept wildcard characters: False ``` ### -TypeHandlerVersion -TypeHandlerVersion. +Specifies the version of the extension. +Specifies the version of the extension. +If this element is not specified or an asterisk (*) is used as the value, the latest version of the extension is used. +If the value is specified with a major version number and an asterisk as the minor version number (X.), the latest minor version of the specified major version is selected. +If a major version number and a minor version number are specified (X.Y), the specific extension version is selected. +If a version is specified, an auto-upgrade is performed on the role instance. ```yaml Type: System.String @@ -160,7 +218,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension ## NOTES diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerConfigurationObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerConfigurationObject.md index cea2c86c4269..64ef08e2a2af 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerConfigurationObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerConfigurationObject.md @@ -1,25 +1,25 @@ --- external help file: Az.CloudService-help.xml Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceloadbalancerconfigurationobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceloadbalancerconfigurationobject schema: 2.0.0 --- # New-AzCloudServiceLoadBalancerConfigurationObject ## SYNOPSIS -Create a in-memory object for LoadBalancerConfiguration +Create an in-memory object for LoadBalancerConfiguration. ## SYNTAX ``` New-AzCloudServiceLoadBalancerConfigurationObject - [-FrontendIPConfiguration ] [-Name ] + -FrontendIPConfiguration -Name [-Id ] [] ``` ## DESCRIPTION -Create a in-memory object for LoadBalancerConfiguration +Create an in-memory object for LoadBalancerConfiguration. ## EXAMPLES @@ -36,11 +36,27 @@ For more details see New-AzCloudService. ## PARAMETERS ### -FrontendIPConfiguration -FrontendIPConfiguration. -To construct, see NOTES section for FRONTENDIPCONFIGURATION properties and create a hash table. +Specifies the frontend IP to be used for the load balancer. +Only IPv4 frontend IP address is supported. +Each load balancer configuration must have exactly one frontend IP configuration. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.ILoadBalancerFrontendIPConfiguration[] +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ILoadBalancerFrontendIPConfiguration[] +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Id +Resource Id. + +```yaml +Type: System.String Parameter Sets: (All) Aliases: @@ -52,14 +68,14 @@ Accept wildcard characters: False ``` ### -Name -Name of LoadBalancerConfiguration. +The name of the Load balancer. ```yaml Type: System.String Parameter Sets: (All) Aliases: -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False @@ -73,7 +89,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerConfiguration +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerConfiguration ## NOTES diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md index 5ee335c8f811..78c297ae0195 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md @@ -1,65 +1,68 @@ --- external help file: Az.CloudService-help.xml Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceloadbalancerfrontendipconfigurationobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceloadbalancerfrontendipconfigurationobject schema: 2.0.0 --- # New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject ## SYNOPSIS -Create a in-memory object for LoadBalancerFrontendIPConfiguration +Create an in-memory object for LoadBalancerFrontendIPConfiguration. ## SYNTAX ### DefaultParameterSet (Default) ``` -New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject [-Name ] [-PublicIPAddressId ] +New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name [-PublicIPAddressId ] [] ``` ### PrivateIP ``` -New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject [-Name ] [-PrivateIPAddress ] +New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name [-PrivateIPAddress ] [-SubnetId ] [] ``` ## DESCRIPTION -Create a in-memory object for LoadBalancerFrontendIPConfiguration +Create an in-memory object for LoadBalancerFrontendIPConfiguration. ## EXAMPLES -### Example 1: Create load balancer frontend IP configuration object +### Example 1: {{ Add title here }} ```powershell -$publicIP = Get-AzPublicIpAddress -ResourceGroupName 'ContosoOrg' -Name 'ContosoPublicIP' -$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -PublicIPAddressId $publicIp.Id -$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig +{{ Add code here }} ``` -This command creates load balancer frontend IP configuration object which is used for creating or updating a cloud service. -For more details see New-AzCloudService. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} -### Example 2: Create load balancer frontend IP configuration object with Private ID address +### Example 2: {{ Add title here }} ```powershell -# Create role profile object -$subnet = New-AzVirtualNetworkSubnetConfig -Name "WebTier" -AddressPrefix "10.0.0.0/24" -WarningAction SilentlyContinue -$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -privateIPAddress '10.0.0.6' -subnetId $Subnet.Id -$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig +{{ Add code here }} +``` + +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} ``` -This command creates load balancer frontend IP configuration object with a Private IP address +{{ Add description here }} ## PARAMETERS ### -Name -Name of FrontendIpConfiguration. +The name of the resource that is unique within the set of frontend IP configurations used by the load balancer. +This name can be used to access the resource. ```yaml Type: System.String Parameter Sets: (All) Aliases: -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False @@ -67,7 +70,7 @@ Accept wildcard characters: False ``` ### -PrivateIPAddress -Private IP Address +The virtual network private IP address of the IP configuration. ```yaml Type: System.String @@ -97,7 +100,7 @@ Accept wildcard characters: False ``` ### -SubnetId -Subnet ID +Resource Id. ```yaml Type: System.String @@ -118,7 +121,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.LoadBalancerFrontendIPConfiguration +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.LoadBalancerFrontendIPConfiguration ## NOTES diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md index 1743982e93ed..d995cd615cbf 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md @@ -23,15 +23,27 @@ Create a in-memory object for Remote Desktop Extension ## EXAMPLES -### Example 1: Create remote desktop extension object +### Example 1: {{ Add title here }} ```powershell -$credential = Get-Credential -$expiration = (Get-Date).AddYears(1) -$extension = New-AzCloudServiceRemoteDesktopExtensionObject -Name 'RDPExtension' -Credential $credential -Expiration $expiration -TypeHandlerVersion '1.2.1' +{{ Add code here }} ``` -This command creates remote desktop extension object which is used for creating or updating a cloud service. -For more details see New-AzCloudService. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} + +### Example 2: {{ Add title here }} +```powershell +{{ Add code here }} +``` + +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} ## PARAMETERS @@ -132,7 +144,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.Extension +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Extension ## NOTES diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceRoleProfilePropertiesObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceRoleProfilePropertiesObject.md index b9c2c3412ae6..1271daf4c053 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceRoleProfilePropertiesObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceRoleProfilePropertiesObject.md @@ -1,14 +1,14 @@ --- external help file: Az.CloudService-help.xml Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudserviceroleprofilepropertiesobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudserviceroleprofilepropertiesobject schema: 2.0.0 --- # New-AzCloudServiceRoleProfilePropertiesObject ## SYNOPSIS -Create a in-memory object for CloudServiceRoleProfileProperties +Create an in-memory object for CloudServiceRoleProfileProperties. ## SYNTAX @@ -18,7 +18,7 @@ New-AzCloudServiceRoleProfilePropertiesObject [-Name ] [-SkuCapacity \
**Standard** \
\
**Basic**. ```yaml Type: System.String @@ -99,7 +101,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS -### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudServiceRoleProfileProperties +### Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudServiceRoleProfileProperties ## NOTES diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md index e2c0226d2635..671b15696c5e 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md @@ -1,14 +1,14 @@ --- external help file: Az.CloudService-help.xml Module Name: Az.CloudService -online version: https://learn.microsoft.com/powershell/module/az.cloudservice/new-azcloudservicevaultsecretgroupobject +online version: https://learn.microsoft.com/powershell/module/Az.CloudService/new-azcloudservicevaultsecretgroupobject schema: 2.0.0 --- # New-AzCloudServiceVaultSecretGroupObject ## SYNOPSIS -Create a in-memory object for Vault Secret Group +Create an in-memory object for CloudServiceVaultSecretGroup. ## SYNTAX @@ -18,19 +18,31 @@ New-AzCloudServiceVaultSecretGroupObject [-Id ] [-CertificateUrl -ResourceGroupName - [-SubscriptionId ] -RoleInstance [-DefaultProfile ] [-AsJob] [-NoWait] + [-SubscriptionId ] [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` +### DeleteViaJsonString +``` +Remove-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName + [-SubscriptionId ] -JsonString [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + +### DeleteViaJsonFilePath +``` +Remove-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName + [-SubscriptionId ] -JsonFilePath [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + ### DeleteViaIdentityExpanded ``` -Remove-AzCloudServiceRoleInstance -InputObject -RoleInstance +Remove-AzCloudServiceRoleInstance -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` @@ -60,7 +74,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: DeleteExpanded +Parameter Sets: DeleteExpanded, DeleteViaJsonString, DeleteViaJsonFilePath Aliases: Required: True @@ -88,7 +102,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -102,6 +115,36 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Delete operation + +```yaml +Type: System.String +Parameter Sets: DeleteViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Delete operation + +```yaml +Type: System.String +Parameter Sets: DeleteViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -NoWait Run the command asynchronously @@ -137,7 +180,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: DeleteExpanded +Parameter Sets: DeleteExpanded, DeleteViaJsonString, DeleteViaJsonFilePath Aliases: Required: True @@ -153,10 +196,10 @@ Value of '*' will signify all role instances of the cloud service. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: DeleteExpanded, DeleteViaIdentityExpanded Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False @@ -169,7 +212,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String -Parameter Sets: DeleteExpanded +Parameter Sets: DeleteExpanded, DeleteViaJsonString, DeleteViaJsonFilePath Aliases: Required: False diff --git a/src/CloudService/CloudService/help/Restart-AzCloudService.md b/src/CloudService/CloudService/help/Restart-AzCloudService.md index 2b644f59d180..d9e8efd9279b 100644 --- a/src/CloudService/CloudService/help/Restart-AzCloudService.md +++ b/src/CloudService/CloudService/help/Restart-AzCloudService.md @@ -15,13 +15,27 @@ Restarts one or more role instances in a cloud service. ### RestartExpanded (Default) ``` Restart-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] - -RoleInstance [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + +### RestartViaJsonString +``` +Restart-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] + -JsonString [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + +### RestartViaJsonFilePath +``` +Restart-AzCloudService -Name -ResourceGroupName [-SubscriptionId ] + -JsonFilePath [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` ### RestartViaIdentityExpanded ``` -Restart-AzCloudService -InputObject -RoleInstance +Restart-AzCloudService -InputObject [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` @@ -81,7 +95,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -95,12 +108,42 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Restart operation + +```yaml +Type: System.String +Parameter Sets: RestartViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Restart operation + +```yaml +Type: System.String +Parameter Sets: RestartViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Name Name of the cloud service. ```yaml Type: System.String -Parameter Sets: RestartExpanded +Parameter Sets: RestartExpanded, RestartViaJsonString, RestartViaJsonFilePath Aliases: CloudServiceName Required: True @@ -145,7 +188,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: RestartExpanded +Parameter Sets: RestartExpanded, RestartViaJsonString, RestartViaJsonFilePath Aliases: Required: True @@ -161,10 +204,10 @@ Value of '*' will signify all role instances of the cloud service. ```yaml Type: System.String[] -Parameter Sets: (All) +Parameter Sets: RestartExpanded, RestartViaIdentityExpanded Aliases: -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False @@ -177,7 +220,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String -Parameter Sets: RestartExpanded +Parameter Sets: RestartExpanded, RestartViaJsonString, RestartViaJsonFilePath Aliases: Required: False diff --git a/src/CloudService/CloudService/help/Restart-AzCloudServiceRoleInstance.md b/src/CloudService/CloudService/help/Restart-AzCloudServiceRoleInstance.md index cf6b6190ad34..e5bbf90f6b52 100644 --- a/src/CloudService/CloudService/help/Restart-AzCloudServiceRoleInstance.md +++ b/src/CloudService/CloudService/help/Restart-AzCloudServiceRoleInstance.md @@ -19,6 +19,13 @@ Restart-AzCloudServiceRoleInstance -CloudServiceName -ResourceGroupName [-PassThru] [-WhatIf] [-Confirm] [] ``` +### RestartViaIdentityRoleInstance +``` +Restart-AzCloudServiceRoleInstance -CloudServiceName -RoleInstanceInputObject + [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] + [-Confirm] [] +``` + ### RestartViaIdentity ``` Restart-AzCloudServiceRoleInstance -InputObject [-DefaultProfile ] [-AsJob] @@ -59,7 +66,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: Restart +Parameter Sets: Restart, RestartViaIdentityRoleInstance Aliases: Required: True @@ -87,7 +94,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity @@ -146,6 +152,21 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RoleInstanceInputObject +Identity Parameter + +```yaml +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +Parameter Sets: RestartViaIdentityRoleInstance +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### -RoleInstanceName Name of the role instance. diff --git a/src/CloudService/CloudService/help/Set-AzCloudServiceUpdateDomain.md b/src/CloudService/CloudService/help/Set-AzCloudServiceUpdateDomain.md index fadb977d136f..508286720c51 100644 --- a/src/CloudService/CloudService/help/Set-AzCloudServiceUpdateDomain.md +++ b/src/CloudService/CloudService/help/Set-AzCloudServiceUpdateDomain.md @@ -8,18 +8,33 @@ schema: 2.0.0 # Set-AzCloudServiceUpdateDomain ## SYNOPSIS -Updates the role instances in the specified update domain. +Walk the role instances in the specified walk domain. ## SYNTAX +### WalkExpanded (Default) ``` Set-AzCloudServiceUpdateDomain -CloudServiceName -ResourceGroupName -UpdateDomain [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` +### WalkViaJsonFilePath +``` +Set-AzCloudServiceUpdateDomain -CloudServiceName -ResourceGroupName -UpdateDomain + [-SubscriptionId ] -JsonFilePath [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + +### WalkViaJsonString +``` +Set-AzCloudServiceUpdateDomain -CloudServiceName -ResourceGroupName -UpdateDomain + [-SubscriptionId ] -JsonString [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + [-WhatIf] [-Confirm] [] +``` + ## DESCRIPTION -Updates the role instances in the specified update domain. +Walk the role instances in the specified walk domain. ## EXAMPLES @@ -78,6 +93,36 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -JsonFilePath +Path of Json file supplied to the Walk operation + +```yaml +Type: System.String +Parameter Sets: WalkViaJsonFilePath +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -JsonString +Json string supplied to the Walk operation + +```yaml +Type: System.String +Parameter Sets: WalkViaJsonString +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -NoWait Run the command asynchronously diff --git a/src/CloudService/CloudService/help/Start-AzCloudService.md b/src/CloudService/CloudService/help/Start-AzCloudService.md index bcd5c5c0e8ba..6354a86b5f80 100644 --- a/src/CloudService/CloudService/help/Start-AzCloudService.md +++ b/src/CloudService/CloudService/help/Start-AzCloudService.md @@ -72,7 +72,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService/help/Stop-AzCloudService.md b/src/CloudService/CloudService/help/Stop-AzCloudService.md index da67fc45a24e..b84d3a0d6e14 100644 --- a/src/CloudService/CloudService/help/Stop-AzCloudService.md +++ b/src/CloudService/CloudService/help/Stop-AzCloudService.md @@ -74,7 +74,6 @@ Accept wildcard characters: False ### -InputObject Identity Parameter -To construct, see NOTES section for INPUTOBJECT properties and create a hash table. ```yaml Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity diff --git a/src/CloudService/CloudService/help/Switch-AzCloudService.md b/src/CloudService/CloudService/help/Switch-AzCloudService.md index b9f38b52349c..7fc0c7d3fe97 100644 --- a/src/CloudService/CloudService/help/Switch-AzCloudService.md +++ b/src/CloudService/CloudService/help/Switch-AzCloudService.md @@ -31,22 +31,27 @@ Swaps VIPs between two cloud service (extended support) load balancers. ## EXAMPLES -### Example 1: Switch cloud service using name +### Example 1: {{ Add title here }} ```powershell -Switch-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca +{{ Add code here }} ``` -Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. -'BService' with be swapped with its swappable cloud service. +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} +``` + +{{ Add description here }} -### Example 2: Switch cloud service using cloud service object +### Example 2: {{ Add title here }} ```powershell -$cs = Get-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca -Switch-AzCloudService -CloudService $cs +{{ Add code here }} +``` + +```output +{{ Add output here (remove the output block if the example doesn't have an output) }} ``` -Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. -'BService' with be swapped with its swappable cloud service. +{{ Add description here }} ## PARAMETERS @@ -80,10 +85,9 @@ Accept wildcard characters: False ``` ### -CloudService -To construct, see NOTES section for CLOUDSERVICE properties and create a hash table. ```yaml -Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.Api20220904.CloudService +Type: Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.CloudService Parameter Sets: CloudService Aliases: diff --git a/src/CloudService/CloudService/help/Update-AzCloudService.md b/src/CloudService/CloudService/help/Update-AzCloudService.md index ad8e8cbeca40..50de2453a9f7 100644 --- a/src/CloudService/CloudService/help/Update-AzCloudService.md +++ b/src/CloudService/CloudService/help/Update-AzCloudService.md @@ -8,7 +8,7 @@ schema: 2.0.0 # Update-AzCloudService ## SYNOPSIS -Create or update a cloud service. +Create a cloud service. Please note some properties can be set only during cloud service creation. ## SYNTAX @@ -20,7 +20,7 @@ Update-AzCloudService -InputObject -Parameter Date: Wed, 17 Sep 2025 11:13:16 +0800 Subject: [PATCH 2/6] update examples --- .../New-AzCloudServiceDiagnosticsExtension.md | 23 ++++------------- ...adBalancerFrontendIPConfigurationObject.md | 25 +++++++++---------- ...loudServiceRemoteDesktopExtensionObject.md | 23 ++++------------- ...ew-AzCloudServiceVaultSecretGroupObject.md | 23 ++++------------- .../examples/Switch-AzCloudService.md | 21 ++++++---------- 5 files changed, 34 insertions(+), 81 deletions(-) diff --git a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceDiagnosticsExtension.md b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceDiagnosticsExtension.md index 0371f56c36d2..937957f22a7b 100644 --- a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceDiagnosticsExtension.md +++ b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceDiagnosticsExtension.md @@ -1,22 +1,9 @@ -### Example 1: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` +### Example 1: Create diagnostics extension object -{{ Add description here }} - -### Example 2: {{ Add title here }} ```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} +$storageAccountKey = Get-AzStorageAccountKey -ResourceGroupName "ContosOrg" -Name "ContosSA" +$configFile = "" +$extension = New-AzCloudServiceDiagnosticsExtension -Name "WADExtension" -ResourceGroupName "ContosOrg" -CloudServiceName "ContosCS" -StorageAccountName "ContosSA" -StorageAccountKey $storageAccountKey[0].Value -DiagnosticsConfigurationPath $configFile -TypeHandlerVersion "1.5" -AutoUpgradeMinorVersion $true ``` -{{ Add description here }} - +This command creates diagnostics extension object which is used for creating or updating a cloud service. For more details see New-AzCloudService. diff --git a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md index 0371f56c36d2..9198d653ab1a 100644 --- a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md +++ b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md @@ -1,22 +1,21 @@ -### Example 1: {{ Add title here }} +### Example 1: Create load balancer frontend IP configuration object + ```powershell -{{ Add code here }} +$publicIP = Get-AzPublicIpAddress -ResourceGroupName 'ContosoOrg' -Name 'ContosoPublicIP' +$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -PublicIPAddressId $publicIp.Id +$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` +This command creates load balancer frontend IP configuration object which is used for creating or updating a cloud service. For more details see New-AzCloudService. -{{ Add description here }} +### Example 2: Create load balancer frontend IP configuration object with Private ID address -### Example 2: {{ Add title here }} ```powershell -{{ Add code here }} -``` +# Create role profile object +$subnet = New-AzVirtualNetworkSubnetConfig -Name "WebTier" -AddressPrefix "10.0.0.0/24" -WarningAction SilentlyContinue +$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -privateIPAddress '10.0.0.6' -subnetId $Subnet.Id +$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} ``` -{{ Add description here }} - +This command creates load balancer frontend IP configuration object with a Private IP address \ No newline at end of file diff --git a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceRemoteDesktopExtensionObject.md b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceRemoteDesktopExtensionObject.md index 0371f56c36d2..2c24598efeba 100644 --- a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceRemoteDesktopExtensionObject.md +++ b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceRemoteDesktopExtensionObject.md @@ -1,22 +1,9 @@ -### Example 1: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` +### Example 1: Create remote desktop extension object -{{ Add description here }} - -### Example 2: {{ Add title here }} ```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} +$credential = Get-Credential +$expiration = (Get-Date).AddYears(1) +$extension = New-AzCloudServiceRemoteDesktopExtensionObject -Name 'RDPExtension' -Credential $credential -Expiration $expiration -TypeHandlerVersion '1.2.1' ``` -{{ Add description here }} - +This command creates remote desktop extension object which is used for creating or updating a cloud service. For more details see New-AzCloudService. diff --git a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceVaultSecretGroupObject.md b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceVaultSecretGroupObject.md index 0371f56c36d2..ba4082640d05 100644 --- a/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceVaultSecretGroupObject.md +++ b/src/CloudService/CloudService.Autorest/examples/New-AzCloudServiceVaultSecretGroupObject.md @@ -1,22 +1,9 @@ -### Example 1: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` +### Example 1: Create vault secret group object -{{ Add description here }} - -### Example 2: {{ Add title here }} ```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} +$keyVault = Get-AzKeyVault -VaultName 'ContosoKeyVault' +$certificate = Get-AzKeyVaultCertificate -VaultName 'ContosoKeyVault' -Name 'ContosoCert' +$secretGroup = New-AzCloudServiceVaultSecretGroupObject -Id $keyVault.ResourceId -CertificateUrl $certificate.SecretId ``` -{{ Add description here }} - +This command creates vault secret group object which is used for creating or updating a cloud service. For more details see New-AzCloudService. diff --git a/src/CloudService/CloudService.Autorest/examples/Switch-AzCloudService.md b/src/CloudService/CloudService.Autorest/examples/Switch-AzCloudService.md index 0371f56c36d2..94251b3a412e 100644 --- a/src/CloudService/CloudService.Autorest/examples/Switch-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/examples/Switch-AzCloudService.md @@ -1,22 +1,15 @@ -### Example 1: {{ Add title here }} +### Example 1: Switch cloud service using name ```powershell -{{ Add code here }} +Switch-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. 'BService' with be swapped with its swappable cloud service. -### Example 2: {{ Add title here }} +### Example 2: Switch cloud service using cloud service object ```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} +$cs = Get-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca +Switch-AzCloudService -CloudService $cs ``` -{{ Add description here }} +Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. 'BService' with be swapped with its swappable cloud service. From 350f64041115e5ce929384c195e9ea027fbfc7f1 Mon Sep 17 00:00:00 2001 From: Jinpei Li Date: Wed, 17 Sep 2025 11:17:38 +0800 Subject: [PATCH 3/6] update examples --- .../Properties/AssemblyInfo.cs | 1 + .../New-AzCloudServiceDiagnosticsExtension.md | 24 ++++------------ ...adBalancerFrontendIPConfigurationObject.md | 25 ++++++++--------- ...loudServiceRemoteDesktopExtensionObject.md | 24 ++++------------ ...ew-AzCloudServiceVaultSecretGroupObject.md | 24 ++++------------ .../docs/Switch-AzCloudService.md | 23 ++++++--------- .../CloudService.Autorest/generate-info.json | 2 +- src/CloudService/CloudService.sln | 28 +++++++++---------- .../CloudService/Az.CloudService.psd1 | 2 +- .../New-AzCloudServiceDiagnosticsExtension.md | 24 ++++------------ ...adBalancerFrontendIPConfigurationObject.md | 26 ++++++++--------- ...loudServiceRemoteDesktopExtensionObject.md | 24 ++++------------ ...ew-AzCloudServiceVaultSecretGroupObject.md | 24 ++++------------ .../help/Switch-AzCloudService.md | 23 ++++++--------- 14 files changed, 95 insertions(+), 179 deletions(-) diff --git a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs index a76bedb0fa31..e7acc9d0c3e3 100644 --- a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs +++ b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs @@ -25,3 +25,4 @@ [assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)] [assembly: System.CLSCompliantAttribute(false)] + diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md index 879328556eef..cb88a51986b1 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceDiagnosticsExtension.md @@ -24,27 +24,15 @@ Create a in-memory object for Diagnostics Extension ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create diagnostics extension object ```powershell -{{ Add code here }} +$storageAccountKey = Get-AzStorageAccountKey -ResourceGroupName "ContosOrg" -Name "ContosSA" +$configFile = "" +$extension = New-AzCloudServiceDiagnosticsExtension -Name "WADExtension" -ResourceGroupName "ContosOrg" -CloudServiceName "ContosCS" -StorageAccountName "ContosSA" -StorageAccountKey $storageAccountKey[0].Value -DiagnosticsConfigurationPath $configFile -TypeHandlerVersion "1.5" -AutoUpgradeMinorVersion $true ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} - -### Example 2: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates diagnostics extension object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. ## PARAMETERS diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md index 726c1dfcaf31..6a88910a2f09 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md @@ -29,27 +29,26 @@ Create an in-memory object for LoadBalancerFrontendIPConfiguration. ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create load balancer frontend IP configuration object ```powershell -{{ Add code here }} +$publicIP = Get-AzPublicIpAddress -ResourceGroupName 'ContosoOrg' -Name 'ContosoPublicIP' +$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -PublicIPAddressId $publicIp.Id +$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates load balancer frontend IP configuration object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. -### Example 2: {{ Add title here }} +### Example 2: Create load balancer frontend IP configuration object with Private ID address ```powershell -{{ Add code here }} -``` +# Create role profile object +$subnet = New-AzVirtualNetworkSubnetConfig -Name "WebTier" -AddressPrefix "10.0.0.0/24" -WarningAction SilentlyContinue +$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -privateIPAddress '10.0.0.6' -subnetId $Subnet.Id +$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} ``` -{{ Add description here }} +This command creates load balancer frontend IP configuration object with a Private IP address ## PARAMETERS diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md index bf4e25f0ffae..353ff89cd25a 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceRemoteDesktopExtensionObject.md @@ -23,27 +23,15 @@ Create a in-memory object for Remote Desktop Extension ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create remote desktop extension object ```powershell -{{ Add code here }} +$credential = Get-Credential +$expiration = (Get-Date).AddYears(1) +$extension = New-AzCloudServiceRemoteDesktopExtensionObject -Name 'RDPExtension' -Credential $credential -Expiration $expiration -TypeHandlerVersion '1.2.1' ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} - -### Example 2: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates remote desktop extension object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. ## PARAMETERS diff --git a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md index 138fcc95c807..027988ef5ff1 100644 --- a/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md +++ b/src/CloudService/CloudService.Autorest/docs/New-AzCloudServiceVaultSecretGroupObject.md @@ -21,27 +21,15 @@ Create an in-memory object for CloudServiceVaultSecretGroup. ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create vault secret group object ```powershell -{{ Add code here }} +$keyVault = Get-AzKeyVault -VaultName 'ContosoKeyVault' +$certificate = Get-AzKeyVaultCertificate -VaultName 'ContosoKeyVault' -Name 'ContosoCert' +$secretGroup = New-AzCloudServiceVaultSecretGroupObject -Id $keyVault.ResourceId -CertificateUrl $certificate.SecretId ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} - -### Example 2: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates vault secret group object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. ## PARAMETERS diff --git a/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md b/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md index fdb94bf2acf4..63cad453bf99 100644 --- a/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Switch-AzCloudService.md @@ -29,27 +29,22 @@ Swaps VIPs between two cloud service (extended support) load balancers. ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Switch cloud service using name ```powershell -{{ Add code here }} +Switch-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. +'BService' with be swapped with its swappable cloud service. -### Example 2: {{ Add title here }} +### Example 2: Switch cloud service using cloud service object ```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} +$cs = Get-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca +Switch-AzCloudService -CloudService $cs ``` -{{ Add description here }} +Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. +'BService' with be swapped with its swappable cloud service. ## PARAMETERS diff --git a/src/CloudService/CloudService.Autorest/generate-info.json b/src/CloudService/CloudService.Autorest/generate-info.json index c916030cfc6a..c45ac32d4060 100644 --- a/src/CloudService/CloudService.Autorest/generate-info.json +++ b/src/CloudService/CloudService.Autorest/generate-info.json @@ -1,3 +1,3 @@ { - "generate_Id": "827390fd-db05-4315-af6c-03b29fac885f" + "generate_Id": "f1836811-f388-47fa-af6b-f007878e0445" } diff --git a/src/CloudService/CloudService.sln b/src/CloudService/CloudService.sln index 35a2e7f023e1..69d0db33457b 100644 --- a/src/CloudService/CloudService.sln +++ b/src/CloudService/CloudService.sln @@ -21,7 +21,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CloudService", "CloudServic EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "CloudService.Autorest", "CloudService.Autorest", "{8D56B996-E5C3-5DFA-8212-71CB87FB279F}" EndProject -Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.CloudService", "..\..\generated\CloudService\CloudService.Autorest\Az.CloudService.csproj", "{3A34EA55-E4D0-4B91-96C4-14188F9F5A43}" +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.CloudService", "..\..\generated\CloudService\CloudService.Autorest\Az.CloudService.csproj", "{46B6960B-5315-4050-9C88-CE9EE439B4A0}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution @@ -117,18 +117,18 @@ Global {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x64.Build.0 = Release|Any CPU {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x86.ActiveCfg = Release|Any CPU {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x86.Build.0 = Release|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Debug|Any CPU.ActiveCfg = Debug|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Debug|Any CPU.Build.0 = Debug|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Debug|x64.ActiveCfg = Debug|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Debug|x64.Build.0 = Debug|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Debug|x86.ActiveCfg = Debug|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Debug|x86.Build.0 = Debug|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Release|Any CPU.ActiveCfg = Release|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Release|Any CPU.Build.0 = Release|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Release|x64.ActiveCfg = Release|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Release|x64.Build.0 = Release|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Release|x86.ActiveCfg = Release|Any CPU - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43}.Release|x86.Build.0 = Release|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|Any CPU.Build.0 = Debug|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x64.ActiveCfg = Debug|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x64.Build.0 = Debug|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x86.ActiveCfg = Debug|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x86.Build.0 = Debug|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|Any CPU.ActiveCfg = Release|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|Any CPU.Build.0 = Release|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x64.ActiveCfg = Release|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x64.Build.0 = Release|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x86.ActiveCfg = Release|Any CPU + {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x86.Build.0 = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE @@ -140,6 +140,6 @@ Global {68D2827E-8679-4F16-B8F7-011F2DD8EF47} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} {A99ED914-A8AE-49E5-A115-D0D4FD5E1926} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} {2C7C5391-8EEA-495F-AFBE-AA8877C35F8B} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} - {3A34EA55-E4D0-4B91-96C4-14188F9F5A43} = {8D56B996-E5C3-5DFA-8212-71CB87FB279F} + {46B6960B-5315-4050-9C88-CE9EE439B4A0} = {8D56B996-E5C3-5DFA-8212-71CB87FB279F} EndGlobalSection EndGlobal diff --git a/src/CloudService/CloudService/Az.CloudService.psd1 b/src/CloudService/CloudService/Az.CloudService.psd1 index 5dd3f36aae62..b41ac6036778 100644 --- a/src/CloudService/CloudService/Az.CloudService.psd1 +++ b/src/CloudService/CloudService/Az.CloudService.psd1 @@ -3,7 +3,7 @@ # # Generated by: Microsoft Corporation # -# Generated on: 2025-09-16 +# Generated on: 2025-09-17 # @{ diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md b/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md index 5b88781b8289..632a7235fa3a 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceDiagnosticsExtension.md @@ -25,27 +25,15 @@ Create a in-memory object for Diagnostics Extension ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create diagnostics extension object ```powershell -{{ Add code here }} +$storageAccountKey = Get-AzStorageAccountKey -ResourceGroupName "ContosOrg" -Name "ContosSA" +$configFile = "" +$extension = New-AzCloudServiceDiagnosticsExtension -Name "WADExtension" -ResourceGroupName "ContosOrg" -CloudServiceName "ContosCS" -StorageAccountName "ContosSA" -StorageAccountKey $storageAccountKey[0].Value -DiagnosticsConfigurationPath $configFile -TypeHandlerVersion "1.5" -AutoUpgradeMinorVersion $true ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} - -### Example 2: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates diagnostics extension object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. ## PARAMETERS diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md index 78c297ae0195..53bfa18ba00e 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject.md @@ -29,27 +29,25 @@ Create an in-memory object for LoadBalancerFrontendIPConfiguration. ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create load balancer frontend IP configuration object ```powershell -{{ Add code here }} +$publicIP = Get-AzPublicIpAddress -ResourceGroupName 'ContosoOrg' -Name 'ContosoPublicIP' +$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -PublicIPAddressId $publicIp.Id +$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates load balancer frontend IP configuration object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. -### Example 2: {{ Add title here }} +### Example 2: Create load balancer frontend IP configuration object with Private ID address ```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} +# Create role profile object +$subnet = New-AzVirtualNetworkSubnetConfig -Name "WebTier" -AddressPrefix "10.0.0.0/24" -WarningAction SilentlyContinue +$feIpConfig = New-AzCloudServiceLoadBalancerFrontendIPConfigurationObject -Name 'ContosoFe' -privateIPAddress '10.0.0.6' -subnetId $Subnet.Id +$loadBalancerConfig = New-AzCloudServiceLoadBalancerConfigurationObject -Name 'ContosoLB' -FrontendIPConfiguration $feIpConfig ``` -{{ Add description here }} +This command creates load balancer frontend IP configuration object with a Private IP address ## PARAMETERS diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md index d995cd615cbf..93406a0b76c1 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceRemoteDesktopExtensionObject.md @@ -23,27 +23,15 @@ Create a in-memory object for Remote Desktop Extension ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create remote desktop extension object ```powershell -{{ Add code here }} +$credential = Get-Credential +$expiration = (Get-Date).AddYears(1) +$extension = New-AzCloudServiceRemoteDesktopExtensionObject -Name 'RDPExtension' -Credential $credential -Expiration $expiration -TypeHandlerVersion '1.2.1' ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} - -### Example 2: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates remote desktop extension object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. ## PARAMETERS diff --git a/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md b/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md index 671b15696c5e..5502cdb3ed16 100644 --- a/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md +++ b/src/CloudService/CloudService/help/New-AzCloudServiceVaultSecretGroupObject.md @@ -22,27 +22,15 @@ Create an in-memory object for CloudServiceVaultSecretGroup. ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Create vault secret group object ```powershell -{{ Add code here }} +$keyVault = Get-AzKeyVault -VaultName 'ContosoKeyVault' +$certificate = Get-AzKeyVaultCertificate -VaultName 'ContosoKeyVault' -Name 'ContosoCert' +$secretGroup = New-AzCloudServiceVaultSecretGroupObject -Id $keyVault.ResourceId -CertificateUrl $certificate.SecretId ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} - -### Example 2: {{ Add title here }} -```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +This command creates vault secret group object which is used for creating or updating a cloud service. +For more details see New-AzCloudService. ## PARAMETERS diff --git a/src/CloudService/CloudService/help/Switch-AzCloudService.md b/src/CloudService/CloudService/help/Switch-AzCloudService.md index 7fc0c7d3fe97..cb64a0b42d77 100644 --- a/src/CloudService/CloudService/help/Switch-AzCloudService.md +++ b/src/CloudService/CloudService/help/Switch-AzCloudService.md @@ -31,27 +31,22 @@ Swaps VIPs between two cloud service (extended support) load balancers. ## EXAMPLES -### Example 1: {{ Add title here }} +### Example 1: Switch cloud service using name ```powershell -{{ Add code here }} +Switch-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca ``` -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} -``` - -{{ Add description here }} +Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. +'BService' with be swapped with its swappable cloud service. -### Example 2: {{ Add title here }} +### Example 2: Switch cloud service using cloud service object ```powershell -{{ Add code here }} -``` - -```output -{{ Add output here (remove the output block if the example doesn't have an output) }} +$cs = Get-AzCloudService -ResourceGroupName "BRGThree" -CloudServiceName BService -SubscriptionId 1133e0eb-b53c-1234-b478-2eac8f04afca +Switch-AzCloudService -CloudService $cs ``` -{{ Add description here }} +Above command invokes the vipswap operation on the Cloud service with name 'BService' and will perform the operation once the user confirms the action on the confirmation prompt. +'BService' with be swapped with its swappable cloud service. ## PARAMETERS From b59dea5c8567c0f0ea8c759bd38bf2c45a2e32ee Mon Sep 17 00:00:00 2001 From: Jinpei Li Date: Thu, 30 Oct 2025 10:44:55 +0800 Subject: [PATCH 4/6] re-generation --- .../Properties/AssemblyInfo.cs | 6 ++-- .../docs/Az.CloudService.md | 2 +- .../CloudService.Autorest/generate-info.json | 2 +- src/CloudService/CloudService.sln | 28 +++++++++---------- .../CloudService/Az.CloudService.psd1 | 10 +++---- 5 files changed, 23 insertions(+), 25 deletions(-) diff --git a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs index e7acc9d0c3e3..d31fac135311 100644 --- a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs +++ b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs @@ -20,9 +20,7 @@ [assembly: System.Reflection.AssemblyCopyrightAttribute("Copyright © Microsoft")] [assembly: System.Reflection.AssemblyProductAttribute("Microsoft Azure PowerShell")] [assembly: System.Reflection.AssemblyTitleAttribute("Microsoft Azure PowerShell - CloudService")] -[assembly: System.Reflection.AssemblyFileVersionAttribute("2.1.0")] -[assembly: System.Reflection.AssemblyVersionAttribute("2.1.0")] +[assembly: System.Reflection.AssemblyFileVersionAttribute("2.1.1")] +[assembly: System.Reflection.AssemblyVersionAttribute("2.1.1")] [assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)] [assembly: System.CLSCompliantAttribute(false)] - - diff --git a/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md b/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md index 2b9def07a448..ad2b6c02b466 100644 --- a/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md @@ -1,6 +1,6 @@ --- Module Name: Az.CloudService -Module Guid: 7b3ddd84-935e-4839-bbe3-ba7d166d2523 +Module Guid: cd501113-cc30-4a3c-a4cc-a8d722e90f99 Download Help Link: https://learn.microsoft.com/powershell/module/az.cloudservice Help Version: 1.0.0.0 Locale: en-US diff --git a/src/CloudService/CloudService.Autorest/generate-info.json b/src/CloudService/CloudService.Autorest/generate-info.json index c45ac32d4060..38f4008531bc 100644 --- a/src/CloudService/CloudService.Autorest/generate-info.json +++ b/src/CloudService/CloudService.Autorest/generate-info.json @@ -1,3 +1,3 @@ { - "generate_Id": "f1836811-f388-47fa-af6b-f007878e0445" + "generate_Id": "529c6217-0b3c-4713-9e27-265d145af90b" } diff --git a/src/CloudService/CloudService.sln b/src/CloudService/CloudService.sln index 69d0db33457b..1659e8cab37a 100644 --- a/src/CloudService/CloudService.sln +++ b/src/CloudService/CloudService.sln @@ -21,7 +21,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CloudService", "CloudServic EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "CloudService.Autorest", "CloudService.Autorest", "{8D56B996-E5C3-5DFA-8212-71CB87FB279F}" EndProject -Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.CloudService", "..\..\generated\CloudService\CloudService.Autorest\Az.CloudService.csproj", "{46B6960B-5315-4050-9C88-CE9EE439B4A0}" +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.CloudService", "..\..\generated\CloudService\CloudService.Autorest\Az.CloudService.csproj", "{54642B92-7215-4236-93FF-E9850961265F}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution @@ -117,18 +117,18 @@ Global {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x64.Build.0 = Release|Any CPU {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x86.ActiveCfg = Release|Any CPU {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x86.Build.0 = Release|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|Any CPU.Build.0 = Debug|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x64.ActiveCfg = Debug|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x64.Build.0 = Debug|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x86.ActiveCfg = Debug|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Debug|x86.Build.0 = Debug|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|Any CPU.ActiveCfg = Release|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|Any CPU.Build.0 = Release|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x64.ActiveCfg = Release|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x64.Build.0 = Release|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x86.ActiveCfg = Release|Any CPU - {46B6960B-5315-4050-9C88-CE9EE439B4A0}.Release|x86.Build.0 = Release|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Debug|Any CPU.Build.0 = Debug|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Debug|x64.ActiveCfg = Debug|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Debug|x64.Build.0 = Debug|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Debug|x86.ActiveCfg = Debug|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Debug|x86.Build.0 = Debug|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Release|Any CPU.ActiveCfg = Release|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Release|Any CPU.Build.0 = Release|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Release|x64.ActiveCfg = Release|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Release|x64.Build.0 = Release|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Release|x86.ActiveCfg = Release|Any CPU + {54642B92-7215-4236-93FF-E9850961265F}.Release|x86.Build.0 = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE @@ -140,6 +140,6 @@ Global {68D2827E-8679-4F16-B8F7-011F2DD8EF47} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} {A99ED914-A8AE-49E5-A115-D0D4FD5E1926} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} {2C7C5391-8EEA-495F-AFBE-AA8877C35F8B} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} - {46B6960B-5315-4050-9C88-CE9EE439B4A0} = {8D56B996-E5C3-5DFA-8212-71CB87FB279F} + {54642B92-7215-4236-93FF-E9850961265F} = {8D56B996-E5C3-5DFA-8212-71CB87FB279F} EndGlobalSection EndGlobal diff --git a/src/CloudService/CloudService/Az.CloudService.psd1 b/src/CloudService/CloudService/Az.CloudService.psd1 index b7d54b1b02f7..722ce42813dc 100644 --- a/src/CloudService/CloudService/Az.CloudService.psd1 +++ b/src/CloudService/CloudService/Az.CloudService.psd1 @@ -3,7 +3,7 @@ # # Generated by: Microsoft Corporation # -# Generated on: 10/9/2025 +# Generated on: 2025-10-30 # @{ @@ -57,10 +57,10 @@ RequiredModules = @(@{ModuleName = 'Az.Accounts'; ModuleVersion = '5.3.0'; }) RequiredAssemblies = 'CloudService.Autorest/bin/Az.CloudService.private.dll' # Script files (.ps1) that are run in the caller's environment prior to importing this module. -# ScriptsToProcess = @() +ScriptsToProcess = @() # Type files (.ps1xml) to be loaded when importing this module -# TypesToProcess = @() +TypesToProcess = @() # Format files (.ps1xml) to be loaded when importing this module FormatsToProcess = 'CloudService.Autorest/Az.CloudService.format.ps1xml' @@ -115,7 +115,7 @@ PrivateData = @{ PSData = @{ # Tags applied to this module. These help with module discovery in online galleries. - Tags = 'Azure','ResourceManager','ARM','PSModule','CloudService' + Tags = 'Azure', 'ResourceManager', 'ARM', 'PSModule', 'CloudService' # A URL to the license for this module. LicenseUri = 'https://aka.ms/azps-license' @@ -140,7 +140,7 @@ PrivateData = @{ } # End of PSData hashtable - } # End of PrivateData hashtable +} # End of PrivateData hashtable # HelpInfo URI of this module # HelpInfoURI = '' From be68ba1cd2f4926cc18f025ce5c9d46bd07cd14d Mon Sep 17 00:00:00 2001 From: Jinpei Li Date: Mon, 3 Nov 2025 11:54:13 +0800 Subject: [PATCH 5/6] Update changelog --- src/CloudService/CloudService/ChangeLog.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/CloudService/CloudService/ChangeLog.md b/src/CloudService/CloudService/ChangeLog.md index 842f2668722e..3daac3a1a3be 100644 --- a/src/CloudService/CloudService/ChangeLog.md +++ b/src/CloudService/CloudService/ChangeLog.md @@ -18,6 +18,7 @@ - Additional information about change #1 --> ## Upcoming Release +* Improved user experience and consistency. This may introduce breaking changes. Please refer to [here](https://go.microsoft.com/fwlink/?linkid=2340249). ## Version 2.1.1 * Preannounced breaking changes. Please refer to https://go.microsoft.com/fwlink/?linkid=2333229 From a933fe0681c2f6bfa50444a65e0539302acbb9e3 Mon Sep 17 00:00:00 2001 From: Jinpei Li Date: Fri, 7 Nov 2025 18:09:02 +0800 Subject: [PATCH 6/6] update --- .../Properties/AssemblyInfo.cs | 2 + .../CloudService.Autorest/README.md | 3 + .../custom/Invoke-AzCloudServiceRebuild.ps1 | 183 ++++++++++++++++++ .../docs/Az.CloudService.md | 2 +- .../docs/Invoke-AzCloudServiceRebuild.md | 8 +- .../CloudService.Autorest/generate-info.json | 2 +- src/CloudService/CloudService.sln | 28 +-- .../CloudService/Az.CloudService.psd1 | 2 +- .../help/Invoke-AzCloudServiceRebuild.md | 20 +- 9 files changed, 219 insertions(+), 31 deletions(-) create mode 100644 src/CloudService/CloudService.Autorest/custom/Invoke-AzCloudServiceRebuild.ps1 diff --git a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs index d31fac135311..72fb10ae8bd5 100644 --- a/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs +++ b/src/CloudService/CloudService.Autorest/Properties/AssemblyInfo.cs @@ -24,3 +24,5 @@ [assembly: System.Reflection.AssemblyVersionAttribute("2.1.1")] [assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)] [assembly: System.CLSCompliantAttribute(false)] + + diff --git a/src/CloudService/CloudService.Autorest/README.md b/src/CloudService/CloudService.Autorest/README.md index accc0e827315..a13634917ca7 100644 --- a/src/CloudService/CloudService.Autorest/README.md +++ b/src/CloudService/CloudService.Autorest/README.md @@ -72,6 +72,9 @@ directive: subject: ^RebuildCloudService$ set: subject: Rebuild + - where: + subject: Rebuild + hide: true - where: variant: ^Restart$|^RestartViaIdentity$|^Reimage$|^ReimageViaIdentity$ subject: ^CloudService$ diff --git a/src/CloudService/CloudService.Autorest/custom/Invoke-AzCloudServiceRebuild.ps1 b/src/CloudService/CloudService.Autorest/custom/Invoke-AzCloudServiceRebuild.ps1 new file mode 100644 index 000000000000..88000079dda5 --- /dev/null +++ b/src/CloudService/CloudService.Autorest/custom/Invoke-AzCloudServiceRebuild.ps1 @@ -0,0 +1,183 @@ + +# ---------------------------------------------------------------------------------- +# Copyright (c) Microsoft Corporation. All rights reserved. +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# http://www.apache.org/licenses/LICENSE-2.0 +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code +# is regenerated. +# ---------------------------------------------------------------------------------- + +<# +.Synopsis +Rebuild Role Instances reinstalls the operating system on instances of web roles or worker roles and initializes the storage resources that are used by them. +If you do not want to initialize storage resources, you can use Reimage Role Instances. +.Description +Rebuild Role Instances reinstalls the operating system on instances of web roles or worker roles and initializes the storage resources that are used by them. +If you do not want to initialize storage resources, you can use Reimage Role Instances. +.Example +$roleInstances = @("ContosoFrontEnd_IN_0", "ContosoBackEnd_IN_1") +Invoke-AzCloudServiceRebuild -ResourceGroupName "ContosOrg" -CloudServiceName "ContosoCS" -RoleInstance $roleInstances +.Example +Invoke-AzCloudServiceRebuild -ResourceGroupName "ContosOrg" -CloudServiceName "ContosoCS" -RoleInstance "*" + +.Inputs +Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity +.Outputs +System.Boolean +.Notes +COMPLEX PARAMETER PROPERTIES + +To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables. + +INPUTOBJECT : Identity Parameter + [CloudServiceName ]: Name of the cloud service. + [IPConfigurationName ]: The IP configuration name. + [Id ]: Resource identity path + [Location ]: Name of the location that the OS version pertains to. + [NetworkInterfaceName ]: The name of the network interface. + [OSFamilyName ]: Name of the OS family. + [OSVersionName ]: Name of the OS version. + [PublicIPAddressName ]: The name of the public IP Address. + [ResourceGroupName ]: Name of the resource group. + [RoleInstanceName ]: Name of the role instance. + [RoleName ]: Name of the role. + [SubscriptionId ]: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. + [UpdateDomain ]: Specifies an integer value that identifies the update domain. Update domains are identified with a zero-based index: the first update domain has an ID of 0, the second has an ID of 1, and so on. +.Link +https://learn.microsoft.com/powershell/module/az.cloudservice/invoke-azcloudservicerebuild +#> +function Invoke-AzCloudServiceRebuild { + [OutputType([System.Boolean])] + [CmdletBinding(DefaultParameterSetName = 'RebuildExpanded', PositionalBinding = $false, SupportsShouldProcess, ConfirmImpact = 'Medium')] + param( + [Parameter(ParameterSetName = 'RebuildExpanded', Mandatory)] + [Parameter(ParameterSetName = 'RebuildViaJsonFilePath', Mandatory)] + [Parameter(ParameterSetName = 'RebuildViaJsonString', Mandatory)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Path')] + [System.String] + # Name of the cloud service. + ${CloudServiceName}, + + [Parameter(ParameterSetName = 'RebuildExpanded', Mandatory)] + [Parameter(ParameterSetName = 'RebuildViaJsonFilePath', Mandatory)] + [Parameter(ParameterSetName = 'RebuildViaJsonString', Mandatory)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Path')] + [System.String] + # Name of the resource group. + ${ResourceGroupName}, + + [Parameter(ParameterSetName = 'RebuildExpanded')] + [Parameter(ParameterSetName = 'RebuildViaJsonFilePath')] + [Parameter(ParameterSetName = 'RebuildViaJsonString')] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Path')] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.DefaultInfo(Script = '(Get-AzContext).Subscription.Id')] + [System.String] + # Subscription credentials which uniquely identify Microsoft Azure subscription. + # The subscription ID forms part of the URI for every service call. + ${SubscriptionId}, + + [Parameter(ParameterSetName = 'RebuildViaIdentityExpanded', Mandatory, ValueFromPipeline)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Path')] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Models.ICloudServiceIdentity] + # Identity Parameter + ${InputObject}, + + [Parameter(ParameterSetName = 'RebuildExpanded', Mandatory)] + [Parameter(ParameterSetName = 'RebuildViaIdentityExpanded', Mandatory)] + [AllowEmptyCollection()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Body')] + [System.String[]] + # List of cloud service role instance names. + # Value of '*' will signify all role instances of the cloud service. + ${RoleInstance}, + + [Parameter(ParameterSetName = 'RebuildViaJsonFilePath', Mandatory)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Body')] + [System.String] + # Path of Json file supplied to the Rebuild operation + ${JsonFilePath}, + + [Parameter(ParameterSetName = 'RebuildViaJsonString', Mandatory)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Body')] + [System.String] + # Json string supplied to the Rebuild operation + ${JsonString}, + + [Parameter()] + [Alias('AzureRMContext', 'AzureCredential')] + [ValidateNotNull()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Azure')] + [System.Management.Automation.PSObject] + # The DefaultProfile parameter is not functional. + # Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription. + ${DefaultProfile}, + + [Parameter()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [System.Management.Automation.SwitchParameter] + # Run the command as a job + ${AsJob}, + + [Parameter(DontShow)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [System.Management.Automation.SwitchParameter] + # Wait for .NET debugger to attach + ${Break}, + + [Parameter(DontShow)] + [ValidateNotNull()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.SendAsyncStep[]] + # SendAsync Pipeline Steps to be appended to the front of the pipeline + ${HttpPipelineAppend}, + + [Parameter(DontShow)] + [ValidateNotNull()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Runtime.SendAsyncStep[]] + # SendAsync Pipeline Steps to be prepended to the front of the pipeline + ${HttpPipelinePrepend}, + + [Parameter()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [System.Management.Automation.SwitchParameter] + # Run the command asynchronously + ${NoWait}, + + [Parameter()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [System.Management.Automation.SwitchParameter] + # Returns true when the command succeeds + ${PassThru}, + + [Parameter(DontShow)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [System.Uri] + # The URI for the proxy server to use + ${Proxy}, + + [Parameter(DontShow)] + [ValidateNotNull()] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [System.Management.Automation.PSCredential] + # Credentials for a proxy server to use for the remote call + ${ProxyCredential}, + + [Parameter(DontShow)] + [Microsoft.Azure.PowerShell.Cmdlets.CloudService.Category('Runtime')] + [System.Management.Automation.SwitchParameter] + # Use the default credentials for the proxy + ${ProxyUseDefaultCredentials} + ) + + process { + Az.CloudService.internal\Invoke-AzCloudServiceRebuild @PSBoundParameters + } +} diff --git a/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md b/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md index ad2b6c02b466..332ce7b5c9d7 100644 --- a/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md +++ b/src/CloudService/CloudService.Autorest/docs/Az.CloudService.md @@ -1,6 +1,6 @@ --- Module Name: Az.CloudService -Module Guid: cd501113-cc30-4a3c-a4cc-a8d722e90f99 +Module Guid: 52e82f0b-562c-410b-8329-571e2a3d46fd Download Help Link: https://learn.microsoft.com/powershell/module/az.cloudservice Help Version: 1.0.0.0 Locale: en-US diff --git a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md index d2f0d436cfb3..27c662f238fb 100644 --- a/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md +++ b/src/CloudService/CloudService.Autorest/docs/Invoke-AzCloudServiceRebuild.md @@ -15,14 +15,14 @@ If you do not want to initialize storage resources, you can use Reimage Role Ins ### RebuildExpanded (Default) ``` -Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] - [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] +Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName -RoleInstance + [-SubscriptionId ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` ### RebuildViaIdentityExpanded ``` -Invoke-AzCloudServiceRebuild -InputObject [-RoleInstance ] +Invoke-AzCloudServiceRebuild -InputObject -RoleInstance [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-Confirm] [-WhatIf] [] ``` @@ -208,7 +208,7 @@ Type: System.String[] Parameter Sets: RebuildExpanded, RebuildViaIdentityExpanded Aliases: -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False diff --git a/src/CloudService/CloudService.Autorest/generate-info.json b/src/CloudService/CloudService.Autorest/generate-info.json index 38f4008531bc..287621df9b02 100644 --- a/src/CloudService/CloudService.Autorest/generate-info.json +++ b/src/CloudService/CloudService.Autorest/generate-info.json @@ -1,3 +1,3 @@ { - "generate_Id": "529c6217-0b3c-4713-9e27-265d145af90b" + "generate_Id": "fc6d1b83-8da7-444a-a615-641592f6c5b3" } diff --git a/src/CloudService/CloudService.sln b/src/CloudService/CloudService.sln index 1659e8cab37a..d4f25b08052b 100644 --- a/src/CloudService/CloudService.sln +++ b/src/CloudService/CloudService.sln @@ -21,7 +21,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CloudService", "CloudServic EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "CloudService.Autorest", "CloudService.Autorest", "{8D56B996-E5C3-5DFA-8212-71CB87FB279F}" EndProject -Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.CloudService", "..\..\generated\CloudService\CloudService.Autorest\Az.CloudService.csproj", "{54642B92-7215-4236-93FF-E9850961265F}" +Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.CloudService", "..\..\generated\CloudService\CloudService.Autorest\Az.CloudService.csproj", "{3652C866-0B93-412B-BCA2-F08808F42869}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution @@ -117,18 +117,18 @@ Global {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x64.Build.0 = Release|Any CPU {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x86.ActiveCfg = Release|Any CPU {66F605AB-247B-47C6-BB0C-614EBFCD6C1E}.Release|x86.Build.0 = Release|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Debug|Any CPU.Build.0 = Debug|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Debug|x64.ActiveCfg = Debug|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Debug|x64.Build.0 = Debug|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Debug|x86.ActiveCfg = Debug|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Debug|x86.Build.0 = Debug|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Release|Any CPU.ActiveCfg = Release|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Release|Any CPU.Build.0 = Release|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Release|x64.ActiveCfg = Release|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Release|x64.Build.0 = Release|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Release|x86.ActiveCfg = Release|Any CPU - {54642B92-7215-4236-93FF-E9850961265F}.Release|x86.Build.0 = Release|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Debug|Any CPU.ActiveCfg = Debug|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Debug|Any CPU.Build.0 = Debug|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Debug|x64.ActiveCfg = Debug|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Debug|x64.Build.0 = Debug|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Debug|x86.ActiveCfg = Debug|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Debug|x86.Build.0 = Debug|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Release|Any CPU.ActiveCfg = Release|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Release|Any CPU.Build.0 = Release|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Release|x64.ActiveCfg = Release|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Release|x64.Build.0 = Release|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Release|x86.ActiveCfg = Release|Any CPU + {3652C866-0B93-412B-BCA2-F08808F42869}.Release|x86.Build.0 = Release|Any CPU EndGlobalSection GlobalSection(SolutionProperties) = preSolution HideSolutionNode = FALSE @@ -140,6 +140,6 @@ Global {68D2827E-8679-4F16-B8F7-011F2DD8EF47} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} {A99ED914-A8AE-49E5-A115-D0D4FD5E1926} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} {2C7C5391-8EEA-495F-AFBE-AA8877C35F8B} = {0487394E-0D5F-4D6D-83A2-26E96E7E2920} - {54642B92-7215-4236-93FF-E9850961265F} = {8D56B996-E5C3-5DFA-8212-71CB87FB279F} + {3652C866-0B93-412B-BCA2-F08808F42869} = {8D56B996-E5C3-5DFA-8212-71CB87FB279F} EndGlobalSection EndGlobal diff --git a/src/CloudService/CloudService/Az.CloudService.psd1 b/src/CloudService/CloudService/Az.CloudService.psd1 index 722ce42813dc..cbb536d05178 100644 --- a/src/CloudService/CloudService/Az.CloudService.psd1 +++ b/src/CloudService/CloudService/Az.CloudService.psd1 @@ -3,7 +3,7 @@ # # Generated by: Microsoft Corporation # -# Generated on: 2025-10-30 +# Generated on: 2025-11-07 # @{ diff --git a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md index 51c14c20f864..88578b9c569d 100644 --- a/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md +++ b/src/CloudService/CloudService/help/Invoke-AzCloudServiceRebuild.md @@ -16,27 +16,27 @@ If you do not want to initialize storage resources, you can use Reimage Role Ins ### RebuildExpanded (Default) ``` Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] - [-RoleInstance ] [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + -RoleInstance [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` -### RebuildViaJsonString +### RebuildViaJsonFilePath ``` Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] - -JsonString [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + -JsonFilePath [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` -### RebuildViaJsonFilePath +### RebuildViaJsonString ``` Invoke-AzCloudServiceRebuild -CloudServiceName -ResourceGroupName [-SubscriptionId ] - -JsonFilePath [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] + -JsonString [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` ### RebuildViaIdentityExpanded ``` -Invoke-AzCloudServiceRebuild -InputObject [-RoleInstance ] +Invoke-AzCloudServiceRebuild -InputObject -RoleInstance [-DefaultProfile ] [-AsJob] [-NoWait] [-PassThru] [-WhatIf] [-Confirm] [] ``` @@ -84,7 +84,7 @@ Name of the cloud service. ```yaml Type: System.String -Parameter Sets: RebuildExpanded, RebuildViaJsonString, RebuildViaJsonFilePath +Parameter Sets: RebuildExpanded, RebuildViaJsonFilePath, RebuildViaJsonString Aliases: Required: True @@ -190,7 +190,7 @@ Name of the resource group. ```yaml Type: System.String -Parameter Sets: RebuildExpanded, RebuildViaJsonString, RebuildViaJsonFilePath +Parameter Sets: RebuildExpanded, RebuildViaJsonFilePath, RebuildViaJsonString Aliases: Required: True @@ -209,7 +209,7 @@ Type: System.String[] Parameter Sets: RebuildExpanded, RebuildViaIdentityExpanded Aliases: -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False @@ -222,7 +222,7 @@ The subscription ID forms part of the URI for every service call. ```yaml Type: System.String -Parameter Sets: RebuildExpanded, RebuildViaJsonString, RebuildViaJsonFilePath +Parameter Sets: RebuildExpanded, RebuildViaJsonFilePath, RebuildViaJsonString Aliases: Required: False