Megosztás a következőn keresztül:

Set-AzureRmStorageAccount

  • Referencia
Modul:
AzureRM.Storage

Módosítja a Tárfiókot.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

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>]

Description

A Set-AzureRmStorageAccount parancsmag módosít egy Azure Storage-fiókot. Ezzel a parancsmaggal módosíthatja a fiók típusát, frissítheti az ügyféltartományt, vagy címkéket állíthat be egy Storage-fiókon.

Példák

1. példa: A Tárfiók típusának beállítása

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

Ez a parancs a Storage-fiók típusát Standard_RAGRS értékre állítja.

2. példa: Egyéni tartomány beállítása tárfiókhoz

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

Ez a parancs egyéni tartományt állít be egy Storage-fiókhoz.

3. példa: A hozzáférési szint értékének beállítása

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

A parancs a hozzáférési szint értékét ritka elérésűnek állítja be.

4. példa: Az egyéni tartomány és címkék beállítása

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

A parancs beállítja egy Storage-fiók egyéni tartományát és címkéit.

5. példa: A Encryption KeySource beállítása Keyvaultra

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

Ez a parancs egy új létrehozott Keyvaulttal állítja be a Encryption KeySource-t.

6. példa: A Encryption KeySource beállítása "Microsoft.Storage" értékre

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

Ez a parancs a Encryption KeySource-t a "Microsoft.Storage" értékre állítja

7. példa: Tárfiók NetworkRuleSet tulajdonságának beállítása JSON-nal

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"})

Ez a parancs egy Storage-fiók NetworkRuleSet tulajdonságát állítja be JSON-nal

8. példa: A NetworkRuleSet tulajdonság lekérése egy Storage-fiókból, és állítsa egy másik Storage-fiókra

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

Ez az első parancs lekéri a NetworkRuleSet tulajdonságot egy Storage-fiókból, a második parancs pedig egy másik Storage-fiókra állítja be.

9. példa: Tárfiók frissítése "Storage" vagy "BlobStorage" típussal "StorageV2" típusú Tárfiókra

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

A parancs "Storage" vagy "BlobStorage" típusú Storage-fiókot frissít a "StorageV2" típusú Storage-fiókra.

Paraméterek

-AccessTier

A parancsmag által módosított Storage-fiók hozzáférési szintjét adja meg. A paraméter elfogadható értékei a következők: gyakori és ritka elérésű. Ha módosítja a hozzáférési szintet, az további díjakat vonhat maga után. További információ: Azure Blob Storage: Gyakori és ritka elérésű tárolási szintek. Ha a Storage-fiók típusa StorageV2 vagy BlobStorage, megadhatja az AccessTier paramétert. Ha a Tárfiók típusa tároló, ne adja meg az AccessTier paramétert.

Típus:String
Elfogadott értékek:Hot, Cool
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AsJob

Parancsmag futtatása a háttérben

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AssignIdentity

Hozzon létre és rendeljen hozzá egy új tárfiók-identitást ehhez a Tárfiókhoz, amely az Azure KeyVaulthoz hasonló kulcskezelési szolgáltatásokkal használható.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-CustomDomainName

Megadja az egyéni tartomány nevét.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:IAzureContextContainer
Aliasok:AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-EnableHttpsTrafficOnly

Azt jelzi, hogy a Tárfiók csak HTTPS-forgalmat engedélyez-e.

Típus:Boolean
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Force

Kényszeríti a módosítást a Storage-fiókba való írásra.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-KeyName

Ha a -KeyvaultEncryption használatával engedélyezi a titkosítást a Key Vaulttal, adja meg a Keyname tulajdonságot ezzel a beállítással.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-KeyvaultEncryption

Azt jelzi, hogy a Microsoft KeyVaultot használja-e a titkosítási kulcsokhoz a Storage Service Encryption használatakor. Ha a KeyName, a KeyVersion és a KeyVaultUri mind be van állítva, a KeySource a Microsoft.Keyvault értékre lesz állítva, függetlenül attól, hogy ez a paraméter be van-e állítva.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-KeyVaultUri

Ha a Key Vault titkosítását a -KeyvaultEncryption paraméter megadásával használja, ezzel a beállítással adja meg az URI-t a Key Vaulthoz.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-KeyVersion

Ha a Key Vault titkosítását a -KeyvaultEncryption paraméter megadásával használja, ezzel a beállítással adja meg az URI-t a kulcsverzióhoz.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Name

Megadja a módosítani kívánt Storage-fiók nevét.

Típus:String
Aliasok:StorageAccountName, AccountName
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-NetworkRuleSet

A NetworkRuleSet a tűzfalak és a virtuális hálózatok konfigurációs szabályainak meghatározására, valamint a hálózati tulajdonságok értékeinek beállítására szolgál, például a szabályok megkerülésére engedélyezett szolgáltatásokra, valamint a meghatározott szabályok egyikével nem egyező kérések kezelésére.

Típus:PSNetworkRuleSet
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ResourceGroupName

Megadja annak az erőforráscsoportnak a nevét, amelyben módosítani szeretné a Tárfiókot.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-SkuName

Megadja a Tárfiók termékváltozatának nevét. A paraméter elfogadható értékei a következők:

  • Standard_LRS – Helyileg redundáns tárolás.
  • Standard_ZRS – Zónaredundáns tárolás.
  • Standard_GRS – Georedundáns tárolás.
  • Standard_RAGRS – Olvasási hozzáférés georedundáns tárolás.
  • Premium_LRS – Prémium helyileg redundáns tárolás. A Standard_ZRS és Premium_LRS típusokat nem módosíthatja más fióktípusokra. Más fióktípusokat nem módosíthatja Standard_ZRS vagy Premium_LRS.
Típus:String
Aliasok:StorageAccountType, AccountType, Type
Elfogadott értékek:Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-StorageEncryption

Azt jelzi, hogy a Storage-fiók titkosításának beállítása a Microsoft által felügyelt kulcsok használatára van-e beállítva.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Tag

Kulcs-érték párok kivonattábla formájában, címkékként a kiszolgálón. Például: @{key0="value0"; key1=$null; key2="value2"}

Típus:Hashtable
Aliasok:Tags
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-UpgradeToStorageV2

Frissítse a Storage-fióktípust a Storage-ról vagy a BlobStorage-ról a StorageV2-re.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UseSubDomain

Azt jelzi, hogy engedélyezi-e a közvetett CName-ellenőrzést.

Típus:Nullable<T>[Boolean]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

Hashtable

Boolean

Kimenetek

PSStorageAccount