< Back

New-AzureService

Wed Jan 30, 2019 5:48 pm

NAME New-AzureService



SYNOPSIS

Creates an Azure service.





SYNTAX

New-AzureService [-ServiceName] <String> [-AffinityGroup] <String> [[-Label] <String>] [[-Description] <String>] [[-ReverseDnsFqdn] <String>] [-Profile

<AzureSMProfile>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]



New-AzureService [-ServiceName] <String> [-Location] <String> [[-Label] <String>] [[-Description] <String>] [[-ReverseDnsFqdn] <String>] [-Profile

<AzureSMProfile>] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]





DESCRIPTION

The New-AzureService cmdlet creates a new Azure service in the current subscription.





PARAMETERS

-ServiceName <String>

Specifies the name of the new service. The name must be unique to the subscription.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-AffinityGroup <String>

Specifies the affinity group associated with the subscription. If you do not specify the Location parameter, an affinity group is required.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Label <String>

Specifies a label for the service. The label may be up to 100 characters in length.



Required? false

Position? 2

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Description <String>

Specifies a description for the service. The description may be up to 1024 characters in length.



Required? false

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ReverseDnsFqdn <String>

Specifies the fully qualified domain name for reverse DNS.



Required? false

Position? 4

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Profile <AzureSMProfile>

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationAction <ActionPreference>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InformationVariable <String>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Location <String>

Specifies the location for the service. A location is required if there isn't a specified Affinity Group.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



NOTES









-------------------------- Example 1: Create a service --------------------------



PS C:\\>New-AzureService -ServiceName "MySvc01" -Label "MyTestService" -Location "South Central US"



This command creates a new service named MySvc01 in the South Central US location.

-------------------------- Example 2: Create a service in an affinity group --------------------------



PS C:\\>New-AzureService -ServiceName "MySvc01" -AffinityGroup NorthRegion



This command creates a new service named MySvc01 using the NorthRegion affinity group.



RELATED LINKS

Get-AzureService

Set-AzureService