Get-AzRmStorageShare

Module:

Az.Storage

Hiermee haalt u opslagbestandsshares op of vermeldt u deze.

Syntaxis

Get-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-Name <String>]
   [-SnapshotTime <DateTime>]
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-IncludeDeleted]
   [-IncludeSnapshot]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-SnapshotTime <DateTime>]
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   [-IncludeDeleted]
   [-IncludeSnapshot]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzRmStorageShare
   [-ResourceId] <String>
   [-GetShareUsage]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

De Get-AzRmStorageShare cmdlet haalt opslagbestandsshares op of vermeldt deze.

Voorbeelden

Voorbeeld 1: Een opslagbestandsshare ophalen met de naam van het opslagaccount en de naam van de share

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

Met deze opdracht haalt u een Opslagbestandsshare op met de naam van het opslagaccount en de naam van de share.

Voorbeeld 2: alle opslagbestandsshares van een opslagaccount weergeven

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes
----     -------- ---------------- ----------           ------- ------- ---------------
share1   5120                     TransactionOptimized
share2   5120                     TransactionOptimized

Met deze opdracht worden alle opslagbestandsshares van een opslagaccount met de naam van het opslagaccount weergegeven.

Voorbeeld 3: Een Opslagblobcontainer ophalen met het opslagaccountobject en de containernaam.

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Get-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120

Met deze opdracht wordt een Storage Blob-container opgehaald met het opslagaccountobject en de containernaam.

Voorbeeld 4: Een opslagbestandsshare ophalen met het gebruik van de share in bytes

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -GetShareUsage

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare  5120                                                2097152

Met deze opdracht haalt u een Opslagbestandsshare op met de naam van het opslagaccount en de sharenaam en neemt u het gebruik van de share op in bytes.

Voorbeeld 5: geef alle opslagbestandsshares van een opslagaccount weer, neem de verwijderde shares op, neem de momentopnamen van de share op

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -IncludeDeleted -IncludeSnapshot

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version          ShareUsageBytes snapshotTime       
----       -------- ---------------- ----------           ------- -------          --------------- ------------       
testshare1 5120                     TransactionOptimized                                          2021-05-10T08:04:08Z
testshare1 5120                     TransactionOptimized                                                      
share1     100                      TransactionOptimized True    01D61FD1FC5498B6

Met deze opdracht worden alle opslagbestandsshares weergegeven, inclusief de verwijderde shares en momentopnamen van shares.

Voorbeeld 6: Een momentopname van één share ophalen

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "testshare1" -SnapshotTime "2021-05-10T08:04:08Z"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime       
----       -------- ---------------- ----------           ------- ------- --------------- ------------       
testshare1 5120                     TransactionOptimized                                 2021-05-10T08:04:08Z

Met deze opdracht krijgt u één momentopname van een bestandsshare met de naam van de share en de tijd van de momentopname.

Voorbeeld 7: Opslagbestandsshares van een opslagaccount weergeven met een filter

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Filter "startswith(name, test)"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name       QuotaGiB EnabledProtocols AccessTier           Deleted Version ShareUsageBytes snapshotTime
----       -------- ---------------- ----------           ------- ------- --------------- ------------
testshare1 5120     SMB              TransactionOptimized
testshare2 5120     SMB              TransactionOptimized

Met deze opdracht worden alle opslagbestandsshares weergegeven met namen die beginnen met 'test'.

Parameters

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Filter

Het filter van de sharenaam. Wanneer dit is opgegeven, worden alleen namen gedeeld die beginnen met het filter. Het filter moet een indeling hebben: startswith(name, <prefix>)

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-GetShareUsage

Geef deze parameter op om het sharegebruik in bytes op te halen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IncludeDeleted

Verwijderde shares opnemen, standaard bevat lijstshares geen verwijderde shares

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IncludeSnapshot

Momentopnamen van shares opnemen, standaard bevatten lijstshares geen momentopnamen van shares.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Name

Naam van share

Type:	String
Aliassen:	N, ShareName
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceGroupName

Naam van resourcegroep.

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ResourceId

Voer de resource-id van een bestandsshare in.

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SnapshotTime

SnapshotTime delen

Type:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-StorageAccount

Opslagaccountobject

Type:	PSStorageAccount
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-StorageAccountName

Naam van opslagaccount.

Type:	String
Aliassen:	AccountName
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

PSStorageAccount

String

Uitvoerwaarden

PSShare