Udostępnij za pośrednictwem

New-AzureRmStorageAccount

  • Odwołanie
Moduł:
AzureRM.Storage

Tworzy konto magazynu.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

New-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-SkuName] <String>
   [-Location] <String>
   [-Kind <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzureRmStorageAccount tworzy konto usługi Azure Storage.

Przykłady

Przykład 1. Tworzenie konta magazynu

PS C:\>New-AzureRmStorageAccount -ResourceGroupName MyResourceGroup -AccountName mystorageaccount -Location westus -SkuName Standard_GRS

To polecenie tworzy konto magazynu dla nazwy grupy zasobów MyResourceGroup.

Przykład 2. Tworzenie konta usługi Blob Storage za pomocą typu BlobStorage i gorącego dostępuTier

PS C:\>New-AzureRmStorageAccount -ResourceGroupName MyResourceGroup -AccountName mystorageaccount -Location westus -SkuName Standard_GRS -Kind BlobStorage -AccessTier Hot

To polecenie tworzy konto usługi Blob Storage z typem BlobStorage i hot AccessTier

Przykład 3: Tworzenie konta magazynu z typem StorageV2 i generowanie i przypisywanie tożsamości dla usługi Azure KeyVault.

PS C:\>New-AzureRmStorageAccount -ResourceGroupName MyResourceGroup -AccountName mystorageaccount -Location westus -SkuName Standard_GRS -Kind StorageV2 -AssignIdentity

To polecenie tworzy konto magazynu z typem StorageV2. Generuje również i przypisuje tożsamość, która może służyć do zarządzania kluczami konta za pośrednictwem usługi Azure KeyVault.

Przykład 4. Tworzenie konta magazynu za pomocą polecenia NetworkRuleSet z formatu JSON

PS C:\>New-AzureRmStorageAccount -ResourceGroupName MyResourceGroup -AccountName mystorageaccount -Location westus -Type Standard_LRS -NetworkRuleSet (@{bypass="Logging,Metrics";
    ipRules=(@{IPAddressOrRange="20.11.0.0/16";Action="allow"},
            @{IPAddressOrRange="10.0.0.0/7";Action="allow"});
    virtualNetworkRules=(@{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1";Action="allow"},
                        @{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2";Action="allow"});
    defaultAction="Deny"})

To polecenie tworzy konto magazynu, które ma właściwość NetworkRuleSet z formatu JSON

Parametry

-AccessTier

Określa warstwę dostępu konta magazynu tworzonego przez to polecenie cmdlet. Dopuszczalne wartości tego parametru to: Gorąca i Chłodna. Jeśli określisz wartość obiektu BlobStorage dla parametru Kind , musisz określić wartość parametru AccessTier . Jeśli określisz wartość storage dla tego parametru Kind , nie określ parametru AccessTier .

Typ:String
Dopuszczalne wartości:Hot, Cool
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AssignIdentity

Wygeneruj i przypisz nową tożsamość konta magazynu dla tego konta magazynu do użycia z usługami zarządzania kluczami, takimi jak Azure KeyVault.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CustomDomainName

Określa nazwę domeny niestandardowej konta magazynu. Wartość domyślna to Storage.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnableHttpsTrafficOnly

Wskazuje, czy konto magazynu włącza tylko ruch HTTPS.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Kind

Określa rodzaj konta magazynu tworzonego przez to polecenie cmdlet. Dopuszczalne wartości tego parametru to:

  • Magazyn. Konto magazynu ogólnego przeznaczenia obsługujące magazyn obiektów blob, tabel, kolejek, plików i dysków.
  • StorageV2. Konto magazynu ogólnego przeznaczenia w wersji 2 (GPv2), które obsługuje obiekty blob, tabele, kolejki, pliki i dyski, z zaawansowanymi funkcjami, takimi jak obsługa warstw danych.
  • BlobStorage. Konto usługi Blob Storage, które obsługuje tylko magazyn obiektów blob. Wartość domyślna to Storage.
Typ:String
Dopuszczalne wartości:Storage, StorageV2, BlobStorage
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Określa lokalizację konta magazynu do utworzenia.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę konta magazynu do utworzenia.

Typ:String
Aliasy:StorageAccountName, AccountName
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-NetworkRuleSet

Element NetworkRuleSet służy do definiowania zestawu reguł konfiguracji dla zapór i sieci wirtualnych, a także ustawiania wartości dla właściwości sieci, takich jak usługi dozwolone do obejścia reguł i sposobu obsługi żądań, które nie są zgodne z żadnym ze zdefiniowanych reguł.

Typ:PSNetworkRuleSet
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów, w której ma zostać dodane konto magazynu.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SkuName

Określa nazwę jednostki SKU konta magazynu tworzonego przez to polecenie cmdlet. Dopuszczalne wartości tego parametru to:

  • Standard_LRS. Magazyn lokalnie nadmiarowy.
  • Standard_ZRS. Magazyn strefowo nadmiarowy.
  • Standard_GRS. Magazyn geograficznie nadmiarowy.
  • Standard_RAGRS. Dostęp do odczytu do magazynu geograficznie nadmiarowego.
  • Premium_LRS. Magazyn lokalnie nadmiarowy w warstwie Premium.
Typ:String
Aliasy:StorageAccountType, AccountType, Type
Dopuszczalne wartości:Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Pary klucz-wartość w postaci tabeli skrótów ustawione jako tagi na serwerze. Na przykład: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tags
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UseSubDomain

Wskazuje, czy włączyć pośrednią walidację rekordu CName.

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Boolean

Dane wyjściowe

PSStorageAccount