Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Test-AzureName

Test-AzureName

microsoft.windowsazure.commands.dll

Synopsis

Tests whether a Microsoft Azure cloud service name, storage service name or service bus namespace name exists or not.

Syntax

Test-AzureName [-Service] [-Name] [<CommonParameters>]

Test-AzureName [-Storage] [-Name] [<CommonParameters>]

Test-AzureName [-ServiceBusNamespace] [-Name] [<CommonParameters>]

Test-AzureName [-Website] [-Name] [<CommonParameters>]

Detailed Description

If the name exists, the cmdlet returns $True. If the name does not exist, it returns $False.

Parameters

-Name <String>

Specifies the name of the service or storage account to test.

Aliases

None

Required?

true

Position

2

Default value

Accept pipeline input?

true (ByPropertyName)

Accept wildcard characters?

false

-Service <SwitchParameter>

Specifies to test for an existing service account.

Aliases

None

Required?

true

Position

1

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-Storage <SwitchParameter>

Specifies to test for an existing storage account.

Aliases

None

Required?

true

Position

1

Default value

Accept pipeline input?

false

Accept wildcard characters?

false

-ServiceBusNamespace <>

Specifies to test for an existing service bus namespace.

Aliases

None

Required?

true

Position

1

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-Website <>

Specifies to test for an existing website.

Aliases

None

Required?

true

Position

1

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type


Return Type


Notes

node-dev, php-dev, python-dev

Examples

-------------- Example 1 --------------

This command tests to see if the "MyNameService1" is an existing Microsoft Azure cloud service name.

          C:\PS>Test-AzureName –Service "MyNameService1"
        

-------------- Example 2 --------------

This command tests to see if the "mystorename1" is an existing Microsoft Azure storage service name.

          C:\PS>Test-AzureName –Storage "mystorename1"
        

-------------- Example 3 --------------

This command tests to see if the "mynamespace" is an existing Microsoft Azure service bus namespace name.

          C:\PS>Test-AzureName –ServiceBusNamespace "mynamespace"