New-AzureStorageContainer
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
New-AzureStorageContainer
Creates a storage container.
Parameter Set: Default
New-AzureStorageContainer [-Name] <String> [[-Permission] <String> ] [-Context <AzureStorageContext> ] [ <CommonParameters>]
This topic describes the cmdlet in the .6.19 version of the Windows Azure PowerShell module. To find out the version of the module you're using, from the Windows Azure PowerShell console, type (get-module azure).version.
Creates a storage container in Windows Azure.
-Context<AzureStorageContext>
Specifies a context for the new container.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a name for the new container.
Aliases |
N,Container |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Permission<String>
Defines the level of public access to this container. By default, the container and any blobs within it are accessible only by the owner of the storage account. To grant anonymous users with read permissions to a container and its blobs, you can set the container permissions to allow public access. Anonymous users can read blobs within a publicly accessible container without authenticating the request. Allowed values are:
--Container, which provides full read access to a container and its blobs. Clients can enumerate blobs within the container through anonymous request, but cannot enumerate containers within the storage account.
--Blob, which provides read access to blob data within a container through anonymous request, but does not provide access to container data. Clients cannot enumerate blobs within the container via anonymous request.
--Off, which restricts access to only the storage account owner.
Aliases |
PublicAccess |
Required? |
false |
Position? |
2 |
Default Value |
Off |
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).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Example 1
This example creates a new storage container.
C:\PS>New-AzureStorageContainer containername -Permission Off
Example 2
This example creates multiple storage containers. It uses the Split method of the .NET String class and then passes the names on the pipeline. For more information about this method, see String.Split Method
C:\PS>"container1 container2 container3".split() | New-AzureStorageContainer -Permission Container