Set-AzureRmStorageAccount

Odwołanie

Moduł:: AzureRM.Storage

Modyfikuje konto magazynu.

Ostrzeżenie

Moduł AzureRM PowerShell został 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

Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-StorageEncryption]
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-KeyvaultEncryption]
   -KeyName <String>
   -KeyVersion <String>
   -KeyVaultUri <String>
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureRmStorageAccount modyfikuje konto usługi Azure Storage. To polecenie cmdlet służy do modyfikowania typu konta, aktualizowania domeny klienta lub ustawiania tagów na koncie usługi Storage.

Przykłady

Przykład 1. Ustawianie typu konta magazynu

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -Type "Standard_RAGRS"

To polecenie ustawia typ konta magazynu na Standard_RAGRS.

Przykład 2. Ustawianie domeny niestandardowej dla konta magazynu

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.contoso.com" -UseSubDomain $True

To polecenie ustawia domenę niestandardową dla konta magazynu.

Przykład 3. Ustawianie wartości warstwy dostępu

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AccessTier Cool

Polecenie ustawia wartość Warstwy dostępu na chłodną.

Przykład 4. Ustawianie niestandardowej domeny i tagów

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.domainname.com" -UseSubDomain $true -Tag @{tag0="value0";tag1="value1";tag2="value2"}

Polecenie ustawia domenę niestandardową i tagi dla konta magazynu.

Przykład 5. Ustawianie wartości KeySource szyfrowania na keyvault

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AssignIdentity
PS C:\>$account = Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount"

PS C:\>$keyVault = New-AzureRmKeyVault -VaultName "MyKeyVault" -ResourceGroupName "MyResourceGroup" -Location "EastUS2"
PS C:\>$key = Add-AzureKeyVaultKey -VaultName "MyKeyVault" -Name "MyKey" -Destination 'Software'
PS C:\>Set-AzureRmKeyVaultAccessPolicy -VaultName "MyKeyVault" -ObjectId $account.Identity.PrincipalId -PermissionsToKeys wrapkey,unwrapkey,get

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion $key.Version -KeyVaultUri $keyVault.VaultUri

To polecenie ustawiło wartość Encryption KeySource przy użyciu nowego utworzonego magazynu kluczy.

Przykład 6. Ustawienie pozycji Encryption KeySource na wartość "Microsoft.Storage"

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -StorageEncryption

To polecenie powoduje ustawienie pozycji Encryption KeySource na wartość "Microsoft.Storage"

Przykład 7. Ustawianie właściwości NetworkRuleSet konta magazynu przy użyciu formatu JSON

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -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="allow"})

To polecenie ustawia właściwość NetworkRuleSet konta magazynu z formatem JSON

Przykład 8. Pobieranie właściwości NetworkRuleSet z konta magazynu i ustawienie jej na inne konto magazynu

PS C:\> $networkRuleSet = (Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount").NetworkRuleSet 
PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount2" -NetworkRuleSet $networkRuleSet

To pierwsze polecenie pobiera właściwość NetworkRuleSet z konta magazynu, a drugie polecenie ustawia je na inne konto magazynu

Przykład 9: Uaktualnianie konta magazynu z rodzajem "Storage" lub "BlobStorage" do konta magazynu typu "StorageV2"

PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -UpgradeToStorageV2

Polecenie uaktualnia konto magazynu z rodzajem "Storage" lub "BlobStorage" do konta magazynu typu "StorageV2".

Parametry

-AccessTier

Określa warstwę dostępu konta magazynu, którą modyfikuje to polecenie cmdlet. Dopuszczalne wartości tego parametru to: Gorąca i Chłodna. Jeśli zmienisz warstwę dostępu, może to spowodować naliczanie dodatkowych opłat. Aby uzyskać więcej informacji, zobacz Azure Blob Storage: Warstwy magazynowania Gorąca i Chłodna. Jeśli konto magazynu ma typ StorageV2 lub BlobStorage, możesz określić parametr AccessTier . Jeśli konto magazynu ma wartość Kind as Storage, nie należy określać 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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-CustomDomainName

Określa nazwę domeny niestandardowej.

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

-Force

Wymusza zapisanie zmiany na koncie magazynu.

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

-KeyName

Jeśli używasz parametru -KeyvaultEncryption w celu włączenia szyfrowania za pomocą usługi Key Vault, określ właściwość Keyname z tą opcją.

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

-KeyvaultEncryption

Wskazuje, czy używać usługi Microsoft KeyVault dla kluczy szyfrowania podczas korzystania z szyfrowania usługi Storage. Jeśli wszystkie wartości KeyName, KeyVersion i KeyVaultUri są ustawione, właściwość KeySource zostanie ustawiona na Wartość Microsoft.Keyvault, niezależnie od tego, czy ten parametr jest ustawiony, czy nie.

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

-KeyVaultUri

W przypadku używania szyfrowania usługi Key Vault przez określenie parametru -KeyvaultEncryption użyj tej opcji, aby określić identyfikator URI usługi Key Vault.

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

-KeyVersion

W przypadku używania szyfrowania usługi Key Vault przez określenie parametru -KeyvaultEncryption użyj tej opcji, aby określić identyfikator URI dla wersji klucza.

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

-Name

Określa nazwę konta magazynu do zmodyfikowania.

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 być modyfikowane 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. 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. Nie można zmienić typów Standard_ZRS i Premium_LRS na inne typy kont. Nie można zmienić innych typów kont na Standard_ZRS lub Premium_LRS.

Typ:	String
Aliasy:	StorageAccountType, AccountType, Type
Dopuszczalne wartości:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-StorageEncryption

Wskazuje, czy skonfigurować szyfrowanie konta magazynu do używania kluczy zarządzanych przez firmę Microsoft.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
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:	True
Akceptowanie symboli wieloznacznych:	False

-UpgradeToStorageV2

Uaktualnij rodzaj konta magazynu z magazynu lub magazynu BlobStorage do magazynu W wersji 2.

Typ:	SwitchParameter
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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

Hashtable

Boolean

Dane wyjściowe

PSStorageAccount

Udostępnij za pośrednictwem

Set-AzureRmStorageAccount

Składnia

Opis

Przykłady

Przykład 1. Ustawianie typu konta magazynu

Przykład 2. Ustawianie domeny niestandardowej dla konta magazynu

Przykład 3. Ustawianie wartości warstwy dostępu

Przykład 4. Ustawianie niestandardowej domeny i tagów

Przykład 5. Ustawianie wartości KeySource szyfrowania na keyvault

Przykład 6. Ustawienie pozycji Encryption KeySource na wartość "Microsoft.Storage"

Przykład 7. Ustawianie właściwości NetworkRuleSet konta magazynu przy użyciu formatu JSON

Przykład 8. Pobieranie właściwości NetworkRuleSet z konta magazynu i ustawienie jej na inne konto magazynu

Przykład 9: Uaktualnianie konta magazynu z rodzajem "Storage" lub "BlobStorage" do konta magazynu typu "StorageV2"

Parametry

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

Dane wejściowe

Dane wyjściowe

Dodatkowe zasoby

Udostępnij za pośrednictwem

Set-AzureRmStorageAccount

Składnia

Opis

Przykłady

Przykład 1. Ustawianie typu konta magazynu

Przykład 2. Ustawianie domeny niestandardowej dla konta magazynu

Przykład 3. Ustawianie wartości warstwy dostępu

Przykład 4. Ustawianie niestandardowej domeny i tagów

Przykład 5. Ustawianie wartości KeySource szyfrowania na keyvault

Przykład 6. Ustawienie pozycji Encryption KeySource na wartość "Microsoft.Storage"

Przykład 7. Ustawianie właściwości NetworkRuleSet konta magazynu przy użyciu formatu JSON

Przykład 8. Pobieranie właściwości NetworkRuleSet z konta magazynu i ustawienie jej na inne konto magazynu

Przykład 9: Uaktualnianie konta magazynu z rodzajem "Storage" lub "BlobStorage" do konta magazynu typu "StorageV2"

Parametry

-AccessTier

-AsJob

-AssignIdentity

-Confirm

-CustomDomainName

-DefaultProfile

-EnableHttpsTrafficOnly

-Force

-KeyName

-KeyvaultEncryption

-KeyVaultUri

-KeyVersion

-Name

-NetworkRuleSet

-ResourceGroupName

-SkuName

-StorageEncryption

-Tag

-UpgradeToStorageV2

-UseSubDomain

-WhatIf

Dane wejściowe

Dane wyjściowe

Linki powiązane

Dodatkowe zasoby