Freigeben über


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 von <algorithm> <data> folgt, wobei Daten der base64-codierte Inhalt des öffentlichen Schlüssels sind. 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

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HasSshKey

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HasSshPassword

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HomeDirectory

Lokales Benutzerstartverzeichnis

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PermissionScope

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

Typ:PSPermissionScope[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Ressourcengruppenname.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SshAuthorizedKey

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

Typ:PSSshPublicKey[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageAccount

Speicherkontoobjekt

Typ:PSStorageAccount
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageAccountName

Speicherkontoname.

Typ:String
Aliase:AccountName
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserName

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

Typ:String
Aliase:Name
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSStorageAccount

Ausgaben

PSLocalUser