New-AzureServiceExtensionConfig

NAME New-AzureServiceExtensionConfig



SYNOPSIS

Creates a cloud service extension configuration for a deployment.





SYNTAX

New-AzureServiceExtensionConfig [[-Role] <String[]>] [[-X509Certificate] <X509Certificate2>] [[-ThumbprintAlgorithm] <String>] [-ExtensionName] <String>

[-ProviderNamespace] <String> [-PublicConfiguration] <String> [-PrivateConfiguration] <String> [-Version] <String> [[-ExtensionId] <String>] [-Profile

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



New-AzureServiceExtensionConfig [[-Role] <String[]>] [-CertificateThumbprint] <String> [[-ThumbprintAlgorithm] <String>] [-ExtensionName] <String>

[-ProviderNamespace] <String> [-PublicConfiguration] <String> [-PrivateConfiguration] <String> [-Version] <String> [[-ExtensionId] <String>] [-Profile

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



New-AzureServiceExtensionConfig [[-Role] <String[]>] [-ExtensionState] <String> [[-ExtensionId] <String>] [-Profile <AzureSMProfile>]

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





DESCRIPTION

The New-AzureServiceExtensionConfig cmdlet creates a cloud service extension configuration for a deployment.





PARAMETERS

-Role <String[]>

Specifies an optional array of roles to specify the remote desktop configuration for. If not specified the remote desktop configuration is applied

as the default configuration for all roles.



Required? false

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-X509Certificate <X509Certificate2>

Specifies an x509 certificate that when specified will be automatically uploaded to the cloud service and used for encrypting the extension private

configuration.



Required? false

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ThumbprintAlgorithm <String>

Specifies a thumbprint hashing algorithm which is used with the thumbprint to identify the certificate. This parameter is optional and the default

is sha1.



Required? false

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ExtensionName <String>

Specifies the name of the extension.



Required? true

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ProviderNamespace <String>

Specifies the Extension's Provider Namespace.



Required? true

Position? 4

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-PublicConfiguration <String>

Specifies the public configuration text.



Required? true

Position? 5

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-PrivateConfiguration <String>

Specifies the private configuration text.



Required? true

Position? 6

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Version <String>

Specifies the extension version.



Required? true

Position? 7

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ExtensionId <String>





Required? false

Position? 8

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



-CertificateThumbprint <String>

Specifies a certificate thumbprint to use to encrypt the private configuration. This certificate has to already exist in the certificate store. If

you do not specify a certificate, this cmdlet creates a certificate.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ExtensionState <String>





Required? true

Position? 2

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 an extension configuration --------------------------



PS C:\\>New-AzureServiceExtensionConfig -ExtensionName 'RDP' -Version '1.0' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration

$p1 -PrivateConfiguration $p2;



This command specifies an extension configuration.

-------------------------- Example 2: Create an extension configuration for a role --------------------------



PS C:\\>New-AzureServiceExtensionConfig -Role WebRole1 -ExtensionName 'RDP' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration

$p1 -PrivateConfiguration $p2;



This command specifies an extension configuration for the role WebRole1.



RELATED LINKS

Get-AzureServiceExtension

Set-AzureServiceExtension