Test-AzureName
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
Test-AzureName
Tests whether a Windows Azure service or storage name is already in use.
Parameter Set: Service
Test-AzureName [-Service] [-Name] <String> [ <CommonParameters>]
Parameter Set: Storage
Test-AzureName [-Storage] [-Name] <String> [ <CommonParameters>]
The Test-AzureName tests whether a Windows Azure service name or storage name is in use. If the name is in use, the cmdlet returns $True. If the name is not being used, it returns $False. You can test for a service name or a storage name.
-Name<String>
Specifies the name of the service or storage account to test.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Service
Specifies to test for an existing service account.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Storage
Specifies to test for an existing storage account.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
-------------- Example 1 --------------
This command tests to see if the "MyNameService1" is an existing Windows Azure service name.
C:\PS>Test-AzureName –Service "MyNameService1"
-------------- Example 2 --------------
This command tests to see if the "mystorename1" is an existing Windows Azure storage account name.
C:\PS>Test-AzureName –Storage "mystorename1"