Share via


Set-AzStorageLocalUser

Erstellt oder aktualisiert einen angegebenen lokalen Benutzer in einem Speicherkonto.

Syntax

Set-AzStorageLocalUser
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -UserName <String>
   [-HomeDirectory <String>]
   [-SshAuthorizedKey <PSSshPublicKey[]>]
   [-PermissionScope <PSPermissionScope[]>]
   [-HasSharedKey <Boolean>]
   [-HasSshKey <Boolean>]
   [-HasSshPassword <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageLocalUser
   -StorageAccount <PSStorageAccount>
   -UserName <String>
   [-HomeDirectory <String>]
   [-SshAuthorizedKey <PSSshPublicKey[]>]
   [-PermissionScope <PSPermissionScope[]>]
   [-HasSharedKey <Boolean>]
   [-HasSshKey <Boolean>]
   [-HasSshPassword <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzStorageLocalUser erstellt oder aktualisiert einen angegebenen lokalen Benutzer in einem Speicherkonto. Zum Ausführen dieses Cmdlets muss das Speicherkonto "EnableLocalUser" bereits als "true" festgelegt haben.

Beispiele

Beispiel 1: Erstellen oder Aktualisieren eines lokalen Benutzers

$sshkey1 = New-AzStorageLocalUserSshPublicKey -Key "ssh-rsa base64encodedkey=" -Description "sshpublickey name1"

$permissionScope1 = New-AzStorageLocalUserPermissionScope -Permission rw -Service blob -ResourceName container1 

$localuser = Set-AzStorageLocalUser -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -UserName testuser1 -HomeDirectory "/" -SshAuthorizedKey $sshkey1 -PermissionScope $permissionScope1 -HasSharedKey $true -HasSshKey $true -HasSshPassword $true

$localuser

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name      Sid                                          HomeDirectory HasSharedKey HasSshKey HasSshPassword PermissionScopes        
----      ---                                          ------------- ------------ --------- -------------- ----------------         
testuser1 S-1-2-0-0000000000-000000000-0000000000-0000 /             True         True      True           [container1]

$localuser.SshAuthorizedKeys 

Description       Key                     
-----------       ---                     
sshpublickey name1 ssh-rsa base64encodedkey=

$localuser.PermissionScopes 

Permissions Service ResourceName
----------- ------- ------------
rw          blob    container1

Der erste Befehl erstellt ein lokales SSH-Objekt für öffentliche Schlüssel. Beachten Sie, dass der Schlüssel dem Format <algorithm> <data> folgt, in dem Daten der base64-codierte Inhalt des öffentlichen Schlüssels ist. Der zweite Befehl erstellt ein lokales Berechtigungsbereichsobjekt, das den Zugriff auf Containerebene für den lokalen Benutzer definiert. Der dritte Befehl erstellt oder aktualisiert den lokalen Benutzer mithilfe der lokalen Objekte aus den ersten 2 Befehlen. Der letzte Befehl zeigt die lokalen Benutzereigenschaften an.

Beispiel 2: Erstellen oder Aktualisieren eines lokalen Benutzers durch Eingabeberechtigungsbereich und SSH-Schlüssel mit json

Set-AzStorageLocalUser -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -UserName testuser1 -HomeDirectory "/" -HasSharedKey $true -HasSshKey $true -HasSshPassword $true `
            -SshAuthorizedKey (@{
                Description="sshpulickey name1";
                Key="ssh-rsa base64encodedkey=";                
            },
            @{
                Description="sshpulickey name2";
                Key="ssh-rsa otherbase64encodedkey="; 
            }) `
            -PermissionScope (@{
                Permissions="rw";
                Service="blob"; 
                ResourceName="container1";                
            },
            @{
                Permissions="rwd";
                Service="share"; 
                ResourceName="share1";
            })

ResourceGroupName: weitry, StorageAccountName: weisftp3

Name      Sid                                          HomeDirectory HasSharedKey HasSshKey HasSshPassword PermissionScopes        
----      ---                                          ------------- ------------ --------- -------------- ----------------         
testuser1 S-1-2-0-0000000000-000000000-0000000000-0000 /             True         True      True           [container1,...]

Dieser Befehl erstellt oder aktualisiert einen lokalen Benutzer durch Eingabeberechtigungsbereich und SSH-Schlüssel mit JSON.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasSharedKey

Gibt an, ob ein freigegebener Schlüssel vorhanden ist. Legen Sie ihn auf "false" fest, um den vorhandenen freigegebenen Schlüssel zu entfernen.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasSshKey

Gibt an, ob SSH-Schlüssel vorhanden ist. Legen Sie ihn auf "false" fest, um den vorhandenen SSH-Schlüssel zu entfernen.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HasSshPassword

Gibt an, ob ssh-Kennwort vorhanden ist. Legen Sie ihn auf "false" fest, um vorhandenes SSH-Kennwort zu entfernen.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HomeDirectory

Lokales Benutzerstartverzeichnis

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PermissionScope

Die Berechtigungsbereiche des lokalen Benutzers. Rufen Sie das Objekt mit dem Cmdlet New-AzStorageLocalUserPermissionScope ab.

Type:PSPermissionScope[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Ressourcengruppenname.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SshAuthorizedKey

Lokale Benutzer ssh autorisierte Schlüssel für SFTP. Rufen Sie das Objekt mit dem Cmdlet New-AzStorageLocalUserSshPublicKey ab.

Type:PSSshPublicKey[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccount

Speicherkontoobjekt

Type:PSStorageAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Speicherkontoname.

Type:String
Aliases:AccountName
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserName

Der Name des lokalen Benutzers. Der Benutzername darf nur Kleinbuchstaben und Zahlen enthalten. Sie darf nur innerhalb des Speicherkontos eindeutig sein.

Type:String
Aliases:Name
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSStorageAccount

Ausgaben

PSLocalUser